Java模块化项目在Jenkins中自动构建的关键是：确保Agent节点安装JDK17+并全局配置工具版本，Maven需设source/target为17、启用maven-compiler-plugin和maven-surefire-plugin（useModulePath=true），多模块依赖由pom.xml声明，Pipeline中避免手动javac而优先用mvn clean install。
Java 模块化项目（基于 Java 9+ 的 module-info.java）在 Jenkins 中实现自动构建，关键在于正确配置 JDK 版本、构建工具识别模块路径、以及处理跨模块依赖。它不是简单改个命令就能跑通，而是需要从环境、工具链到流水线逻辑层层对齐。
确保 JDK 版本与模块系统兼容
Jenkins 默认可能使用旧版 JDK，而模块化要求 JDK 9 或更高版本（推荐 JDK 17/21 LTS）。需确认两点：
- 主节点和所有 Agent 节点上安装的是支持模块系统的 JDK（如 OpenJDK 17），并已通过
java -version验证 - Jenkins 全局工具配置中，为 Maven/Gradle 显式指定该 JDK（而非继承系统默认），避免构建时仍用 JDK 8 导致
module-info.java: error: modules are not supported in -source 8
适配 Maven 构建行为
Maven 本身不原生感知 Java 模块，但可通过插件和配置支持模块化编译与验证：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 在
pom.xml中启用maven-compiler-plugin并设<source>17</source>和<target>17</target> - 添加
maven-jar-plugin配置，确保生成的 JAR 包包含Automatic-Module-Name或正确写入module-info.class - 若项目含多模块（如
core、api、service），Maven 聚合构建天然支持模块间依赖解析——只要各子模块pom.xml正确声明<parent>和<modules>，Jenkins 执行mvn clean install即可按拓扑顺序编译、测试、安装
Jenkinsfile 中显式控制模块路径
对于非标准结构或需额外模块选项的场景，可在 Pipeline 中手动传参：
立即学习“Java免费学习笔记（深入）”；
- 编译阶段加入
--module-path和--add-modules参数（例如：sh 'javac --module-path target/dependency --add-modules ALL-SYSTEM -d target/classes $(find src -name "*.java")'） - 更推荐方式是让 Maven 处理，仅在 Jenkinsfile 中校验模块图：
sh 'java --list-modules | grep my.module.name'或运行mvn exec:java -Dexec.mainClass="org.example.Main"测试模块启动 - 若使用 JLink 制作自定义运行时镜像，需在 Jenkins 构建后阶段调用
jlink，并确保 Agent 环境 PATH 包含对应 JDK 的bin/
处理常见失败点
模块化项目在 Jenkins 中报错，八成集中在以下三类：
-
“module not found”：检查
target/classes/module-info.class是否生成；确认src/main/java/module-info.java位置正确，且未被 Maven 资源过滤规则排除 -
“requires transitive but not exported”：说明某依赖模块未导出包，需在对应模块的
module-info.java中补exports pkg;，或改用requires static降级处理 -
测试阶段 ClassNotFound：JUnit 5 默认不支持模块路径加载，建议在
pom.xml中使用maven-surefire-plugin3.0+，并配置<useModulePath>true</useModulePath>
