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