Java 9错误‘not in a module...’及多模块Gradle构建问题求助

我之前升级Java 9模块项目时也碰到过这个错误，核心原因是Gradle没正确识别模块结构，或是模块源路径、依赖配置出了问题。咱们一步步来搞定它：

1. 先确认module-info.java的位置正确性 #

Java模块系统要求每个模块的module-info.java必须放在模块的主源码根目录下，你需要确保：

• org.ggp.base模块的module-info.java确实在org.ggp.base/src/main/java/下（你已经提到了，这个位置是对的）
• pl.edu.prz.klopusz模块的module-info.java必须放在pl.edu.prz.klopusz/dolar-app/src/main/java/下，不能放在任何子目录里，否则Gradle会把它当成普通类文件，而非模块声明。

2. 配置Gradle启用Java 9模块支持 #

因为你用Gradle构建，必须明确开启模块系统支持，分场景配置：

根项目build.gradle（多项目构建时） #

如果是多项目结构，在根目录的配置文件里统一设置：

subprojects {
    apply plugin: 'java'

    java {
        sourceCompatibility = JavaVersion.VERSION_1_9
        targetCompatibility = JavaVersion.VERSION_1_9

        // 关键：启用模块路径自动推断
        modularity.inferModulePath = true
    }

    repositories {
        mavenCentral()
    }
}

org.ggp.base模块的build.gradle #

需要正确声明对pl.edu.prz.klopusz模块的依赖，注意Java模块系统下的依赖引用方式：

dependencies {
    // 如果pl.edu.prz.klopusz是本地子模块，用project依赖
    implementation project(':pl.edu.prz.klopusz')
    // 如果是已发布到仓库的模块，用module依赖格式
    // implementation module('pl.edu.prz.klopusz:pl.edu.prz.klopusz:你的版本号')
}

同时要在org.ggp.base的module-info.java里添加模块依赖声明：

module org.ggp.base {
    requires pl.edu.prz.klopusz;
    // 其他模块声明（导出包、服务等）...
}

pl.edu.prz.klopusz模块的build.gradle #

确保模块被Gradle正确识别：

java {
    modularity.inferModulePath = true
}

并且在它的module-info.java里导出包含抽象类的包，让org.ggp.base能访问：

module pl.edu.prz.klopusz {
    exports pl.edu.prz.klopusz.你的抽象类所在包名;
    // 其他模块声明...
}

3. 修正settings.gradle的模块路径配置 #

如果是多项目构建，根目录的settings.gradle必须正确包含两个模块，并指定非标准位置的模块路径：

include ':org.ggp.base'
include ':pl.edu.prz.klopusz'
// 关键：指定pl.edu.prz.klopusz模块的实际目录
project(':pl.edu.prz.klopusz').projectDir = new File(settingsDir, 'pl.edu.prz.klopusz/dolar-app')

这一步很容易忽略——如果Gradle找不到模块的正确目录，就会把它当成普通类库，而非模块，直接触发目标错误。

4. 清理缓存并重新构建 #

执行以下命令清理旧构建缓存，重新执行构建（加--info可以查看模块处理的详细日志，方便排查剩余问题）：

./gradlew clean build --info

额外排查点 #

• 检查两个模块的module-info.java中的模块名，必须和Gradle配置、依赖声明里的名称完全一致（比如module org.ggp.base { ... }不能写错）
• 建议使用Gradle 5.x及以上版本（Java 9支持从Gradle 4.6开始，但高版本的模块兼容性更稳定）
• 如果pl.edu.prz.klopusz之前是无模块的普通JAR，必须添加module-info.java才能让它成为Java模块，否则org.ggp.base无法通过模块系统引用它。

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