JaCoCo Maven 插件在执行 check 目标时因 标签位置错误导致解析失败，本文详解正确配置结构，提供可运行的 XML 示例，并说明各关键参数含义及常见陷阱。
jacoco maven 插件在执行 `check` 目标时因 `
在使用 JaCoCo Maven Plugin 实现构建时的覆盖率强制校验（即低于阈值则构建失败）时，一个常见却隐蔽的错误是 XML 配置层级错位——特别是
✅ 正确配置结构如下（已适配 JaCoCo 0.8.9+ 版本）：
<plugin><groupid>org.jacoco</groupid><artifactid>jacoco-maven-plugin</artifactid><version>0.8.9</version><configuration><outputdirectory>${project.build.directory}/jacoco</outputdirectory><excludes><exclude>com/mycompany/config/**</exclude></excludes></configuration><executions><!-- 启用测试代理以收集覆盖率数据 --><execution><id>prepare-agent</id><goals><goal>prepare-agent</goal></goals></execution><!-- 执行覆盖率检查（需在 test 或 verify 阶段触发） --><execution><id>check</id><phase>test</phase><!-- 推荐设为 test，确保在单元测试后立即校验 --><goals><goal>check</goal></goals><configuration><rules><rule><element>CLASS</element><!-- ✅ 正确位置：rule 的直接子元素 --><limits><limit><counter>INSTRUCTION</counter><value>COVEREDRATIO</value><minimum>0.90</minimum></limit><!-- 可选：追加分支覆盖率校验 --><limit><counter>BRANCH</counter><value>COVEREDRATIO</value><minimum>0.85</minimum></limit></limits></rule><!-- 可选：对特定包单独设置更严格规则 --><rule><element>PACKAGE</element><includes><include>com.mycompany.service.*</include></includes><limits><limit><counter>LINE</counter><value>COVEREDRATIO</value><minimum>0.95</minimum></limit></limits></rule></rules></configuration></execution></executions></plugin>
? 关键要点说明：
必须位于 下，取值可为 BUNDLE, PACKAGE, CLASS, SOURCEFILE, METHOD 或 COMPLEXITY，定义校验作用域； 是 的子元素，内部可包含多个 ，支持混合校验（如指令、分支、行覆盖）； 显式指定执行阶段（如 test）可避免 mvn install 因生命周期顺序问题未触发 check； - 若未显式绑定 phase，check 默认在 verify 阶段执行，此时需运行 mvn verify（而非仅 mvn test）才能触发校验。
⚠️ 注意事项：
- mvn test 仅执行 test 阶段，若 check 未绑定到该阶段，则不会运行——这是“构建未失败”的常见原因；
- 确保 prepare-agent 和 check 使用相同版本插件（推荐统一声明
在 级）； - 排除路径（
）不影响 check 规则匹配逻辑，仅影响数据采集范围； - 若需调试，添加 -X 参数运行 Maven 查看详细插件配置解析日志。
通过修正层级结构并合理绑定生命周期阶段，即可实现精准、可靠的覆盖率门禁控制，让质量约束真正落地于 CI/CD 流水线中。
