)
兄弟搞了這么多年Maven構(gòu)建你該不會還是那三板斧吧——mvn clean、mvn package、mvn install敲到底我見過不少號稱玩了三年Maven的人問他mvn install到底干了幾個插件的活他愣是說不全。Maven插件這塊確實是很多人的知識盲區(qū)但偏偏它才是Maven真正的靈魂。標(biāo)題說得直白點Maven本身啥活都不干編譯是maven-compiler-plugin在干打包是maven-jar-plugin在干部署是maven-deploy-plugin在干你敲的每條命令本質(zhì)都是在給插件下發(fā)指令。這篇文章我想從插件生命周期綁定的底層邏輯聊起再把參數(shù)解析、自定義插件這些硬核玩法掰開揉碎講給你聽無論你是剛?cè)胄械男率诌€是在用Maven的老油條看完你都能對構(gòu)建過程形成自己的掌控力而不是被Maven牽著鼻子走。1. Maven不死之謎為什么你天天用Maven卻從沒懂過插件1.1 先看清Maven的“軀殼”與“靈魂”我經(jīng)常跟同事打一個比方Maven這個構(gòu)建工具其實就像一個公司里的項目經(jīng)理他自己不寫代碼、不測試、不打包、不部署他只負責(zé)制定流程、安排工期、最后清點交付成果。真正干活的是他手下那些“施工隊”每個施工隊只負責(zé)一種類型的任務(wù)而Maven把這些施工隊統(tǒng)稱為“插件”。這個類比能幫你理解Maven插件機制的核心結(jié)構(gòu)。Maven進程啟動后會先解析你項目里的pom.xml把所有的構(gòu)建步驟整理成一份“施工計劃表”這份計劃表就是Maven的生命周期Lifecycle。然后再把生命周期中的每一個“時間節(jié)點”Phase映射到具體的施工隊上——也就是插件Plugin和它的目標(biāo)Goal。最后在真正執(zhí)行的時候Maven挨個把施工隊喊過來干活施工隊干完活再把結(jié)果匯報回來Maven確認無誤后才進入下一個節(jié)點。這就是為什么我標(biāo)題里說“別再只會mvn install了”。你執(zhí)行mvn install的時候Maven可沒有自己去“安裝”任何東西。它會去調(diào)用maven-resources-plugin復(fù)制資源文件調(diào)用maven-compiler-plugin編譯源碼調(diào)用maven-surefire-plugin跑單元測試調(diào)用maven-jar-plugin打jar包最后調(diào)用maven-install-plugin把產(chǎn)物搬進本地倉庫。這整個過程發(fā)生在一條路上生命周期階段負責(zé)指路插件目標(biāo)負責(zé)落地。你得把這兩者的協(xié)作邏輯搞明白才算真正入了Maven的門。1.2 生命周期、階段、插件目標(biāo)三角關(guān)系的底層模型我們先看清楚Maven生命周期的全貌。Maven定義了三條內(nèi)置生命周期clean清理、default構(gòu)建、site生成站點。其中default生命周期是你平時打交道最多的它完整定義了從編譯到部署的22個階段我這里列出高頻率出現(xiàn)的那幾個所屬生命周期階段名稱主要職責(zé)cleanpre-clean清理前動作cleanclean刪除target目錄cleanpost-clean清理后動作defaultvalidate校驗項目信息defaultcompile編譯主源碼defaulttest運行單元測試defaultpackage打包成jar/wardefaultverify集成測試等校驗defaultinstall安裝到本地倉庫defaultdeploy部署到遠程倉庫一個關(guān)鍵機制是只要你指定了某個階段Maven會把這個階段之前的所有階段都執(zhí)行一遍。比如你執(zhí)行mvn installMaven會自動先執(zhí)行validate、compile、test、package、verify等。這個“自動”是插件綁定機制在背后起的作用而綁定的規(guī)則就存在每個插件內(nèi)置的META-INF/maven/plugin.xml以及Maven的default-bindings里。默認綁定邏輯是這樣的對于特定的打包類型jar、war、pomMaven會為default生命周期里的每個階段預(yù)設(shè)一個插件目標(biāo)。舉個例子jar打包的項目在compile階段默認綁定的是maven-compiler-plugin:compile在test階段默認綁定的是maven-surefire-plugin:test。你不需要在pom里顯式聲明任何東西Maven也會按這套默認規(guī)則執(zhí)行。而如果你想自定義行為比如想在package階段順便跑一個代碼生成器的目標(biāo)就需要在pom的buildplugins里手動聲明并把它綁定到某個階段。這其實就是“再做一層映射”。1.3 搞懂插件模型后你能獲得什么理解這套三角關(guān)系帶來的收益是實實在在的。第一你能準確預(yù)測每次構(gòu)建的行為。團隊里出現(xiàn)過“為什么本地構(gòu)建好好的CI上就報錯”的經(jīng)典問題很多都是因為根目錄的settings.xml或父pom的pluginManagement不一樣導(dǎo)致插件版本不同。第二你能自己編排構(gòu)建流程而不是在Maven的框架下束手束腳。比如我經(jīng)常需要在一個項目里做“按模塊定制化打包”默認邏輯根本滿足不了最終就是寫了個自定義插件綁定到package階段把workflow交給Maven統(tǒng)一調(diào)度。第三你能在遇到構(gòu)建錯誤時不再對著紅色日志發(fā)呆而是能快速定位是哪個插件、哪個目標(biāo)、哪個階段出的問題。說白了Maven插件原理沒那么玄乎核心就一句話Maven負責(zé)流程調(diào)度插件負責(zé)具體執(zhí)行。下面我?guī)阋徊讲桨堰@句話拆開看看怎么能用它指導(dǎo)真實項目的構(gòu)建優(yōu)化。2. 深入插件機制goal、execution、phase、configuration到底怎么配合2.1 從一次真實的mvn驗證說開去假設(shè)你在項目根目錄執(zhí)行一條再常見不過的命令mvn verify這條命令背后發(fā)生的事情遠比你想象的多。verify屬于default生命周期中靠后的一個階段Maven在解析時會把它前面的所有階段串起來從validate開始依次走過initialize、generate-sources、process-sources、generate-resources、process-resources、compile等直到verify為止。每一階段都會去找它綁定的插件目標(biāo)。你用-X參數(shù)啟動調(diào)試模式就能看到這個執(zhí)行鏈類似下面這樣mvn verify -X日志中會出現(xiàn)大量--- maven-resources-plugin:3.3.1:testResources (default-testResources) projectName ---這樣的片段。拆解一下這段日志maven-resources-plugin是插件名3.3.1是插件版本testResources是goaldefault-testResources是execution的id projectName是對哪個模塊執(zhí)行??炊@段日志你就看懂了Maven執(zhí)行時的真實調(diào)度路徑。別怕日志長長日志里全是金礦。2.2 五個核心概念的精確含義Maven插件的文檔里最讓人頭大的就是一堆名詞來回混用。我?guī)湍銖氐桌砬逡幌虏寮lugin一組完成特定任務(wù)的goal的集合以groupId:artifactId:version坐標(biāo)形式存在例如org.apache.maven.plugins:maven-compiler-plugin:3.13.0。目標(biāo)goal插件里的一個具體任務(wù)方法相當(dāng)于一個類里的方法。比如compiler插件里有compile和testCompile兩個目標(biāo)。階段phase生命周期中的位置點本身不做任何事只是調(diào)度觸發(fā)器。比如package階段觸發(fā)jar插件的jar目標(biāo)。執(zhí)行execution將一個goal綁定到一個phase上的動作。同一個goal可以創(chuàng)建多個execution綁定到不同的phase附帶不同的配置。配置configuration給某個目標(biāo)或執(zhí)行傳入的參數(shù)集合控制插件行為。為了讓你看明白它們是怎么串聯(lián)的我給你寫一段標(biāo)準的pom片段build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId version3.13.0/version configuration source17/source target17/target encodingUTF-8/encoding /configuration executions execution idcompile-with-extra-arg/id phasecompile/phase goals goalcompile/goal /goals configuration compilerArgs arg-Xlint:unchecked/arg /compilerArgs /configuration /execution /executions /plugin /plugins /build在這個例子里configuration部分是直接寫在整個plugin下的它對插件的所有目標(biāo)生效而execution內(nèi)部的configuration只對這個名為compile-with-extra-arg的execution生效。Maven的配置合并規(guī)則是“execution級配置覆蓋plugin級配置plugin級配置覆蓋pom級屬性pom級屬性覆蓋插件默認值”。這個覆蓋規(guī)則比你想的要常用比如同一份代碼既要在JDK8上編譯又要出JDK17的產(chǎn)物你就可以建兩個execution分別配置不同的release參數(shù)互不干擾。2.3 參數(shù)到底是怎么傳進插件里的很多初學(xué)自定義插件的人最困惑的是我在pom里寫configurationsource17/source/configuration插件里的Java代碼怎么拿到這個數(shù)值這里面的機制值得說透。Maven在實例化插件時會掃描插件的Mojo類Mojo是Maven的舊稱“Plain Old Java Object”和插件目標(biāo)的結(jié)合體即“Maven plain Java goal implementation”。Mojo類里的字段如果被Parameter注解標(biāo)記就說明該字段可以通過配置注入。Maven會根據(jù)Parameter里聲明的name或alias去pom的configuration節(jié)點中查找對應(yīng)標(biāo)簽。找到之后做類型轉(zhuǎn)換——字符串類型轉(zhuǎn)成數(shù)字、布爾、枚舉集合類型則需要根據(jù)XML結(jié)構(gòu)做裝配。更妙的是Parameter注解有一個property屬性。一旦指定了property這個字段的值就可以直接被命令行-D參數(shù)覆蓋。這是Maven插件體系中最靈活的機制之一。例如Parameter(property mysql.version, defaultValue 8.0.33) private String mysqlVersion;執(zhí)行命令時指定-Dmysql.version5.7.44插件運行起來后mysqlVersion字段的值就會被覆蓋為5.7.44。這個機制讓你可以在不改pom的情況下動態(tài)傳參特別適合CI流水線中的參數(shù)化構(gòu)建。2.4 默認綁定的那些坑了解默認綁定后最怕的就是你以為沒配置就是沒配置。這里有個經(jīng)典誤區(qū)在buildplugins里只添加maven-compiler-plugin但沒綁定execution你心想“我已經(jīng)配了編譯插件編譯肯定沒問題”。真實情況是Maven不會因為你聲明了插件就自動執(zhí)行它除非它有默認goal綁定。compiler插件的compilegoal確實有默認綁定到compile階段所以你能編譯但如果你引入的某個插件的goal沒有默認階段綁定就必須手動聲明execution否則執(zhí)行期它不會跑。我看過太多人踩這個坑往pom里加了一個flatten-maven-plugin只寫了version沒寫executions然后構(gòu)建報錯“mojo not found in plugin”或者壓根沒執(zhí)行。原因就是它沒有默認phase。所以你一定要養(yǎng)成習(xí)慣新增插件時第一件事看它的文檔哪些goal有默認綁定哪些需要手動phase。這一條能幫你省掉大量無意義的排錯時間。3. 帶你手寫一個Maven插件從骨架到上線只需四步3.1 插件的骨架怎么生成講完了原理是時候動點真格的了。我建議每個有兩年以上Maven使用經(jīng)驗的人都親手寫一個自定義插件。不是為了炫技而是寫插件的過程能讓你對之前講的參數(shù)注入、生命周期綁定產(chǎn)生肌肉記憶。新建一個Maven項目打包方式設(shè)為maven-plugingroupIdcom.example.build/groupId artifactIdsource-stat-maven-plugin/artifactId version1.0.0/version packagingmaven-plugin/packaging注意這個packaging它的值不是jar而是maven-plugin。這個打包類型會觸發(fā)maven-plugin-plugin的默認行為掃描你源碼里的Mojo注解并自動生成plugin.xml描述文件。該描述文件相當(dāng)于插件的“說明書”Maven運行時需要通過它來發(fā)現(xiàn)有哪些goal、哪些參數(shù)。接著引入兩個必要的依賴dependencies dependency groupIdorg.apache.maven/groupId artifactIdmaven-plugin-api/artifactId version3.9.6/version scopeprovided/scope /dependency dependency groupIdorg.apache.maven.plugin-tools/groupId artifactIdmaven-plugin-annotations/artifactId version3.13.0/version scopeprovided/scope /dependency /dependencies之所以用provided是因為這些依賴在Maven運行時環(huán)境里已經(jīng)存在了不需要打進插件包里。寫插件最忌諱的就是把Maven自身的類庫也打個包帶上最后引起類沖突。3.2 核心Mojo類的編寫思路我來寫一個實際能用的小插件統(tǒng)計源碼根目錄下的Java文件行數(shù)輸出到日志里。目標(biāo)很簡單但你已經(jīng)能從中看到Mojo類的完整骨架。完整的類長這樣package com.example.build.maven; import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.plugins.annotations.LifecyclePhase; import org.apache.maven.plugins.annotations.Mojo; import org.apache.maven.plugins.annotations.Parameter; import java.io.IOException; import java.nio.file.Files; import java.nio.file.Path; import java.nio.file.Paths; import java.util.stream.Stream; Mojo(name count-lines, defaultPhase LifecyclePhase.COMPILE, threadSafe true) public class SourceLineCounterMojo extends AbstractMojo { Parameter(property sourceDir, defaultValue ${project.build.sourceDirectory}) private String sourceDir; Parameter(property countOnlyJava, defaultValue true) private boolean countOnlyJava; Override public void execute() throws MojoExecutionException { getLog().info(開始掃描源碼目錄 sourceDir); Path root Paths.get(sourceDir); if (!Files.exists(root)) { getLog().warn(源碼目錄不存在跳過統(tǒng)計); return; } long total 0; long fileCount 0; try (StreamPath paths Files.walk(root)) { for (Path p : paths.filter(Files::isRegularFile).toList()) { if (countOnlyJava !p.toString().endsWith(.java)) { continue; } fileCount; try (var lines Files.lines(p)) { total lines.count(); } } } catch (IOException e) { throw new MojoExecutionException(讀取源碼文件失敗, e); } getLog().info(String.format(共掃描到 %d 個文件總行數(shù) %d, fileCount, total)); } }逐段解釋。Mojo注解聲明了三塊關(guān)鍵信息name是goal的名字你在命令行執(zhí)行的source-stat:count-lines里的count-lines就來自這里defaultPhase聲明了默認綁定階段如果不配置execution它會自動綁定到compile階段threadSafe告訴Maven這個Mojo可以并行執(zhí)行在開啟-T并行構(gòu)建時不會被排斥。Parameter則聲明了兩個可配置參數(shù)。sourceDir默認值用了${project.build.sourceDirectory}這是Maven的內(nèi)建表達式等價于src/main/java的實際絕對路徑。最精彩的是property sourceDir這行它讓命令行參數(shù)-DsourceDirxxx可以覆蓋默認值真正實現(xiàn)了靈活傳參。3.3 參數(shù)注入與依賴注入的底層邏輯剛才那個例子里我們使用了Parameter注入了字符串和布爾值。可Maven插件里能玩的花樣遠不止這些。除了基礎(chǔ)類型你還可以注入Maven的上下文對象比如Parameter(defaultValue ${project}) private MavenProject project;注入了項目對象之后你就能拿到project.getArtifactId()、project.getDependencies()、project.getBuild().getDirectory()等等一連串信息。這是插件和項目交互的萬能鑰匙。還有一類注入是Component用于注入Maven內(nèi)部組件。比如你想在插件里用MavenProject構(gòu)建器或者ArtifactResolver來下載依賴可以這樣寫Component private ArtifactResolver artifactResolver;不過這一類屬于進階用法牽涉到Maven內(nèi)部的plexus容器一上來不建議碰。你把Parameter的幾種注入方式玩明白已經(jīng)能覆蓋絕大多數(shù)業(yè)務(wù)場景了。3.4 安裝并驗證你的第一個自定義插件寫完代碼后在項目根目錄執(zhí)行mvn install它會把插件安裝到本地倉庫~/.m2/repository/com/example/build/source-stat-maven-plugin/1.0.0/下。接著我們到另一個測試項目里在pom的buildplugins片段中引入這個插件plugin groupIdcom.example.build/groupId artifactIdsource-stat-maven-plugin/artifactId version1.0.0/version executions execution phasecompile/phase goals goalcount-lines/goal /goals /execution /executions /plugin然后運行mvn compile你會看到目標(biāo)日志里出現(xiàn)“開始掃描源碼目錄”和“共掃描到 xx 個文件總行數(shù) xx”。到這里你已經(jīng)完全掌握了一個自定義插件的完整生命周期寫Mojo、聲明參數(shù)、綁定phase、mvn install、被其他項目消費。3.5 一個容易被忽略但極其重要的打包細節(jié)maven-plugin-plugin生成plugin.xml描述文件時會把plugin.xml里記錄的goal前綴也生成好。默認情況下goals前綴是插件的artifactId去掉maven-前綴和-plugin后綴之后的部分。比如我們的source-stat-maven-plugin默認前綴就是source-stat。但如果你想讓前綴友好一些可以在maven-plugin-plugin里顯式配置plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-plugin-plugin/artifactId version3.13.0/version configuration goalPrefixsource-stat/goalPrefix /configuration /plugin這個配置不只是在命令行里讓你少敲幾個字母更重要的是它寫入plugin.xml后會影響mvn help:describe的輸出、IDE對Maven插件的提示以及團隊協(xié)作時別人能否快速識別你的插件是干嘛的。細節(jié)拉滿體驗才能拉滿。4. 版本沖突、插件不執(zhí)行、參數(shù)被吞問題排查的硬核思路4.1 版本沖突與依賴收斂的解決套路Maven插件踩坑排行榜里版本沖突穩(wěn)居前三。典型場景是這樣的你項目里引入了插件A插件A內(nèi)部依賴了plexus-utils:1.5.5而你的項目直接依賴了plexus-utils:2.0.0。這時構(gòu)建行為有可能因為類加載順序不同而“薛定諤式地”出錯——有時編譯沒問題有時莫名其妙拋NoSuchMethodError。排查這個問題有一套固定動作。先跑mvn dependency:tree -Dincludesorg.codehaus.plexus:plexus-utils看依賴樹里有哪些版本。接著看插件間的依賴沖突用mvn dependency:resolve-plugins這個命令會列出所有已解析插件及其傳遞依賴配合-Dverbose還能看到每個依賴的來源路徑。定位到?jīng)_突后解決辦法通常有三種在plugindependencies里顯式指定某個依賴的版本強制覆蓋。在pluginManagement里統(tǒng)一插件版本進而統(tǒng)一其傳遞依賴。換掉引入沖突依賴的插件版本。這里我要特別強調(diào)pluginManagement的巨大價值。它不像dependencies那樣直接聲明插件而是相當(dāng)于“配置模板”。真正使用時子模塊或當(dāng)前模塊引用插件時只需要寫groupId和artifactId版本和配置全部從pluginManagement繼承。這個機制能把幾十個模塊的插件版本全部收斂到一處管理可以說是治理多模塊項目的基石。4.2 插件在構(gòu)建中“消失”了怎么辦“我在pom里聲明了插件構(gòu)建時它卻完全沒跑?!边@是我被問過最多的問題之一。排查這類問題建議你按下面四步來第一檢查插件是否寫在了pluginManagement而不是plugins里。pluginManagement只做配置聲明不做執(zhí)行綁定很多新人誤以為在它里面加插件就會生效。第二檢查插件的goal是否綁定了phase。有些插件goal的defaultPhase被定義為none這時候必須給execution手動指定phase。第三檢查構(gòu)建命令指定的階段是否在你綁定階段的“前面”。比如你把插件綁定到了deploy階段卻執(zhí)行mvn compile那它自然不會運行。第四打開調(diào)試日志確認mvn compile -X | grep plugin-name由于Maven版本更新很快有些插件的綁定信息可能在日志里被折疊這時你可以看一下effective-pom它能幫你確認最終生效的pom里插件有沒有被正常解析和綁定。4.3 參數(shù)“被吞”的三個經(jīng)典原因有時候插件確實執(zhí)行了但行為跟你配置的configuration不一致。我把常見原因歸成三類第一類參數(shù)名拼寫錯誤。XML標(biāo)簽名必須與Mojo類里Parameter注解聲明的name或字段名完全匹配大小寫敏感。比如sourceDir你寫成了source-dir映射不到就會靜默忽略或報錯。第二類execution級配置覆蓋了plugin級配置。如果你的configuration寫在plugin級但execution內(nèi)部有同名配置最終生效的是execution里的那個值。第三類property屬性被命令行覆蓋。很多人不知道命令行-D參數(shù)優(yōu)先級最高改pom沒改CI腳本結(jié)果本地好了CI依舊按老參數(shù)走。排查“參數(shù)被吞”最有效的手段是看調(diào)試日志中的Configuring mojo片段。Maven在執(zhí)行插件前會把這個goal最終使用的參數(shù)完整打印出來。日志長沒關(guān)系重點看你想驗證的那幾個字段即可。4.4 多模塊項目特有插件問題速查多模塊構(gòu)建的坑跟單模塊完全不在一個量級。我整理一個速查表給你癥狀可能原因排查動作子模塊報插件版本不一致根pom的pluginManagement沒鎖定版本在根pom統(tǒng)一pluginManagement插件在父模塊執(zhí)行但子模塊不執(zhí)行插件寫在父pom的build.plugins里但子模塊繼承了卻沒有觸發(fā)goal確認插件是否帶默認綁定必要時在子模塊顯式聲明executions子模塊覆蓋配置后父模塊配置失效子模塊重寫了整個插件配置用 pluginManagement 作為模板子模塊引用時增量覆蓋多個子模塊并行構(gòu)建時報錯插件不是線程安全的給Mojo加threadSafe true或關(guān)閉并行構(gòu)建不同模塊需要的插件版本不同模塊間依賴差異化配置用 profile 或 properties 區(qū)分場景這些問題的共性是“繼承與覆蓋的邊界不清”。我給你的通用建議是版本和公共配置往pluginManagement放具體的goal綁定往各模塊自己的build/plugins放。這樣既保證統(tǒng)一性又保留靈活性。5. 進階玩法利用插件機制實現(xiàn)構(gòu)建流程的自定義編排5.1 將多個插件目標(biāo)編排成一個構(gòu)建“流水線”當(dāng)你理解插件原理后就能像樂高一樣自由拼裝構(gòu)建流程了。我曾經(jīng)接手過一個跨平臺系統(tǒng)它的構(gòu)建邏輯非常復(fù)雜先生成接口定義代碼然后編譯接著做協(xié)議轉(zhuǎn)換再打包成可執(zhí)行程序最后還需要把構(gòu)建產(chǎn)物上傳到內(nèi)部的統(tǒng)一發(fā)布平臺。默認生命周期根本沒法直接覆蓋但我們可以通過綁定多個插件目標(biāo)到不同階段來“拼接”出完整流程。舉一個具體編排思路。在generate-sources階段綁定代碼生成插件的目標(biāo)在process-classes階段綁定字節(jié)碼增強插件的目標(biāo)在package階段綁定自定義打包插件的目標(biāo)。這里不是簡單地把一堆插件堆到pom里而是要把每段邏輯“切”到最合適的生命周期位置。選擇階段的標(biāo)準是什么我一般看這個任務(wù)依賴哪些構(gòu)建產(chǎn)物。它如果只依賴源碼就放早一點依賴編譯后的class就放process-classes或更靠后依賴最終包就放package之后。5.2 跳過插件執(zhí)行的高級技巧實戰(zhàn)中還經(jīng)常遇到需要跳過某類插件但不動pom的場景。比如本地開發(fā)想跳過測試但不想改pom你早就知道用-DskipTests。但你知道這個參數(shù)是怎么生效的嗎它在原理上就是匹配到了surefire插件testgoal里Parameter(property skipTests)字段。插件機制就是這么通透。類似的還有跳過打包、跳過執(zhí)行某些代碼質(zhì)量檢查插件。關(guān)鍵是你要會查每個插件的skip參數(shù)對應(yīng)的property名。比如maven-jar-plugin的skip參數(shù)對應(yīng)-Dmaven.jar.skiptruemaven-install-plugin的skip參數(shù)對應(yīng)-Dmaven.install.skiptrue。在維護大型項目時這些命令行開關(guān)能讓你在不影響別人構(gòu)建的前提下快速繞坑。5.3 與profile結(jié)合按環(huán)境動態(tài)切換插件配置這是Maven插件體系的另一個高價值應(yīng)用場景。部署到不同環(huán)境時你希望生產(chǎn)環(huán)境打出的包里包含特定的配置模板測試環(huán)境打出的包里則用另一套??梢酝ㄟ^profile來聲明不同環(huán)境下啟用不同插件配置。核心思想是profile可以注入pluginconfigurationprofile激活時配置生效不激活時配置忽略。比如用環(huán)境變量envprod激活一個profile它專門覆蓋maven-resources-plugin的resources指向src/main/resources-prod目錄。這樣mvn package -Denvprod打的包就自動包含生產(chǎn)配置。這類動態(tài)組裝讓構(gòu)建參數(shù)真正活了起來也給team里的自動化發(fā)布留足了控制空間。6. 一個少有人提但極其重要的習(xí)慣構(gòu)建之后看日志里的三分鐘我接觸過很多開發(fā)和運維同學(xué)他們排錯的第一步就是看報錯紅字看到紅字就改代碼改完再構(gòu)建。但我的個人習(xí)慣是即使構(gòu)建成功我也會花三分鐘掃一遍mvn輸出的關(guān)鍵日志。不是看那些虛線框起來的BUILD SUCCESS而是看每一個--- plugin:goal (execution-id) ---片段。確認一遍實際運行的插件順序和數(shù)量如果某次構(gòu)建比平時少了某個插件那很可能是配置文件被改動或profile激活狀態(tài)變了。我自己踩過的一次深刻的坑是某次發(fā)版時項目構(gòu)建完全成功但線上包行為異常。后來排查發(fā)現(xiàn)CI流水線里傳了個-Dmaven.site.skiptrue而這個參數(shù)導(dǎo)致站點插件靜默跳過連帶把代碼文檔生成也跳過了。如果當(dāng)時在我能在構(gòu)建日志里發(fā)現(xiàn)缺少的那一行這個事故完全可以避免。這也是我希望你在讀完這篇文章后真正沉淀下來的核心能力Maven插件是構(gòu)建系統(tǒng)的肌肉而日志是神經(jīng)系統(tǒng)的反饋??炊寮砟憔涂炊藰?gòu)建的可能性邊界。這個邊界內(nèi)絕大部分重復(fù)的體力活都能自動化值得我們花時間去打磨。下次再有人敲一個mvn install就交差你可以淡定地問他一句你知道這條命令背后調(diào)了多少個插件嗎那時候你大概就比昨天的自己更靠近Maven的本質(zhì)了。