Java 9+模块化项目在Gradle中配置的关键是模块声明、构建脚本与IDE支持三者协同：module-info.java须置于src/main/java根目录，Gradle需启用modularity.inferModulePath=true，IDEA须设JDK 11+并重载项目。
Java 9+ 模块化项目在 Gradle 中配置，关键不是简单加 module-info.java，而是让模块声明、构建脚本、IDE 支持三者协同——Gradle 本身不原生强制模块化，但能完整支持 JPMS（Java Platform Module System），前提是路径、插件、依赖和编译选项全部对齐。
module-info.java 必须存在且位置正确
每个参与模块化的子模块，其 src/main/java 下必须有 module-info.java，且位于最顶层包路径（即与 java 同级）。例如：
-
common/src/main/java/module-info.java✅ -
common/src/main/java/com/example/common/module-info.java❌（会被忽略）
内容需明确声明模块名、导出包、所需依赖：
module com.example.common {
exports com.example.common.util;
requires java.base;
requires transitive com.fasterxml.jackson.core; // 注意：模块名需匹配实际 JAR 的 Automatic-Module-Name
}
Gradle 配置要启用模块路径（--module-path）
默认 Java 插件走 classpath，必须显式启用模块模式。在子模块的 build.gradle 中添加：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
java {
modularity.inferModulePath = true // 自动识别 module-info.java 并启用 --module-path
}
compileJava {
options.compilerArgs += [
'--add-modules', 'ALL-SYSTEM',
'--add-exports', 'java.base/jdk.internal.ref=ALL-UNNAMED'
]
}
注意：modularity.inferModulePath = true 是核心开关，否则 Gradle 会把 module-info.java 当普通源文件跳过编译。
依赖声明需区分“自动模块”与“命名模块”
第三方库（如 Jackson、Guava）多数未真正模块化，仅带 Automatic-Module-Name MANIFEST 属性。Gradle 中仍用常规方式引入，但 module-info.java 中 requires 的名称必须与其 Automatic-Module-Name 一致：
- Maven 坐标：
com.fasterxml.jackson.core:jackson-databind:2.15.2 - 对应模块名（查其 jar 的 MANIFEST.MF）：
com.fasterxml.jackson.databind - 所以
module-info.java写：requires com.fasterxml.jackson.databind;
若不确定模块名，可用 jar -f xxx.jar | grep "Automatic-Module-Name" 查看。
IntelliJ IDEA 需同步启用模块支持
即使 Gradle 构建成功，IDEA 若未识别模块结构，仍会报 package not visible 或运行配置灰色。务必检查：
- Project SDK 设为 JDK 11/17/21（非 JRE），Language level ≥ 11
- 每个模块的 Module Settings → Dependencies → Module SDK 和 Module language level 单独设为匹配值
- File → Project Structure → Modules → 选中模块 → Sources 标签页，确认
src/main/java标记为 Sources，且module-info.java所在目录未被排除
必要时执行 File → Reload project from Gradle 强制刷新模块图。
