Maven pom.xml build plugins 插件配置详解

2次阅读

插件必须配置在下才会执行,仅管理模板;maven-compiler-plugin的source/target控制语法和字节码版本,推荐用release;surefire需合规命名和junit 5显式配置;resources默认生效但需显式声明非标准路径和utf-8编码。

Maven pom.xml build plugins 插件配置详解

plugin 配置写在 <build></build> 还是 <pluginmanagement></pluginmanagement>

写错位置会导致插件完全不生效,尤其新手常把 maven-compiler-plugin 配在 <pluginmanagement></pluginmanagement> 里却没在 <plugins></plugins> 中显式声明,结果编译还是用默认 JDK 5 语义。

<pluginmanagement></pluginmanagement> 只是“模板管理”,不触发执行;真正要运行的插件必须出现在 <build><plugins></plugins></build> 下。

  • 如果是单模块项目,直接配在 <build><plugins></plugins></build> 里最稳妥
  • 多模块时,父 pom 用 <pluginmanagement></pluginmanagement> 统一版本和默认配置,子 pom 在 <plugins></plugins> 中只写 <plugin><groupid></groupid></plugin> + <artifactid></artifactid> 即可继承
  • <pluginmanagement></pluginmanagement> 里配了 <executions></executions>,子 pom 不重写 <executions></executions> 就不会执行——这点极易被忽略

maven-compiler-pluginsourcetarget 到底控制什么?

它们不决定你用什么 JDK 编译,而是告诉插件:“按这个 Java 版本语法和字节码规范来生成 class”。如果设成 11 却用 JDK 8 执行 mvn compile,会直接报错 Unsupported class file major version 55

  • source 控制源码语法(比如能否用 varswitch 表达式)
  • target 控制生成的 class 文件兼容目标 jvm(影响能否在低版本 JRE 上运行)
  • 从 Maven 3.8+ 开始,推荐用 release 参数替代二者,例如 <release>11</release>,它会自动绑定语言、字节码、API 三者,避免 source=11,target=8 这种危险组合
  • 注意:JDK 17+ 默认启用 --enable-preview 相关特性需额外配置,不是靠 source/target 开关

为什么 maven-surefire-plugin 有时不跑测试,或跑完显示 0 tests

常见原因是测试类命名不合规,或测试方法签名/修饰符不对,Maven 默认只认 <em>Test.java</em>Test.java*Tests.java 这三类文件名。

  • 测试方法必须是 public void、无参、非 Static,且以 test 开头(JUnit 4)或标注 @Test(JUnit 5)
  • JUnit 5 需显式引入 maven-surefire-plugin 2.22.0+,并配置 <provider>junit-jupiter</provider>,否则默认只加载 JUnit 4 引擎
  • 若测试在 src/test/java 之外,得通过 <testsourcedirectory></testsourcedirectory> 指定路径,否则 Surefire 根本不扫描
  • 并行执行时加了 <forkmode></forkmode><usesystemclassloader></usesystemclassloader> 错误值,也可能导致类加载失败而跳过测试

打包时资源没打进 jar,maven-resources-plugin 需要手动配吗?

不需要。Maven 默认就绑定了 resources:resourcesprocess-resources 阶段,但默认只处理 src/main/resourcessrc/test/resources,且过滤关闭。

  • 如果资源在其他目录(如 config/),必须用 <resources></resources> 显式声明,并设 <filtering>true</filtering> 才能替换 ${xxx} 占位符
  • 过滤开启后,xml/properties 文件里的 $ 符号可能被误解析,建议用 ${xxx} 转义
  • encoding 不设的话,默认用平台编码(windows 是 GBK),中文乱码多源于此,务必统一设为 UTF-8
  • 注意:插件本身不决定“打不打进 final jar”,那是 maven-jar-pluginmaven-assembly-plugin 的事,resources 只负责复制到 target/classes

Maven 插件的行为高度依赖阶段绑定、默认约定和隐式继承,改一个配置项常牵出三个副作用。最麻烦的不是不会配,而是配了却不知道它在哪一环失效了。

text=ZqhQzanResources