Java应用编译时无法找到自动模块（plexus.utils等）问题

问题背景 #

负责的大型Java项目（环境：Java 17 Temurin、Gradle 7.6、IntelliJ 2022.3）启用Java模块支持后，出现编译错误：使用plexus-utils的代码提示找不到plexus.utils模块，kafka-clients也存在同样问题。

相关配置与现象：

• 代码中引入org.codehaus.plexus.util.Base64，未启用模块前运行正常
• Gradle依赖已配置implementation "org.codehaus.plexus:plexus-utils:3.5.0"
• module-info.java中添加了requires plexus.utils;
• 手动查看plexus-utils-3.5.0.jar的自动模块名，确认是plexus.utils
• 其他无完整模块支持的库（如org.slf4j）可正常识别

排查方向 #

1. Gradle依赖传递性检查

   • 确认子模块是否正确继承主项目的依赖配置，或是否存在依赖排除规则导致plexus-utils未被引入
   • 执行./gradlew dependencies查看当前模块的依赖树，确认plexus-utils是否在编译类路径中

2. Gradle模块系统配置

   • Gradle对JPMS的自动识别可能存在延迟，需显式指导其处理自动模块

3. 缓存清理

   • Gradle缓存可能存在过期数据，清理后重新构建：

     ./gradlew clean build --refresh-dependencies
     

解决方案 #

方案1：强制Gradle识别自动模块 #

在模块的build.gradle中添加配置，确保Gradle将plexus-utils视为自动模块：

tasks.withType(JavaCompile) {
    options.compilerArgs += [
        '--module-path', classpath.asPath,
        '--add-modules', 'plexus.utils'
    ]
}

方案2：使用Gradle模块别名（Gradle 7+支持） #

在依赖配置中显式指定模块别名，消除Gradle对自动模块名的识别歧义：

implementation("org.codehaus.plexus:plexus-utils:${plexusVersion}") {
    moduleAlias 'plexus.utils'
}

方案3：检查并修复子模块依赖 #

如果当前是子模块，确保其build.gradle中直接引入了plexus-utils依赖，而非仅依赖主项目的配置：

implementation "org.codehaus.plexus:plexus-utils:${plexusVersion}"

针对kafka-clients的通用解决思路 #

1. 执行jar --file=kafka-clients-xxx.jar --describe-module获取其自动模块名
2. 在module-info.java中添加requires [自动模块名];
3. 参考上述plexus-utils的配置方案，确保Gradle正确识别该自动模块

内容的提问来源于stack exchange，提问作者Nigel Jones