Java模块化系统全面解析

Java模块化系统远不止是添加一个module-info.java文件那么简单，它是一套精密的封装与访问控制机制：module-info.java作为模块的强制“身份证”，必须严格遵循位置、命名和语法规范；exports仅解决包级可见性，而opens才是反射访问私有成员的唯一合法途径；混用模块路径与类路径会意外生成破坏封装性的自动模块，引发运行时崩溃与依赖冲突；真正落地模块化，关键在于精准权衡导出、开放与封闭的边界——尤其当Spring、Hibernate、Jackson等框架试图绕过模块检查时，开发者必须比框架更清楚每一行requires、exports和opens背后的权限契约。

module-info.java 是 Java 模块化系统的“身份证”——没有它，JVM 就不认为你写的是模块；有了它，但写错一行，就可能编译失败、类找不到、反射报 IllegalAccessError。

module-info.java 怎么写才不被 JVM 拒绝

它不是可选配置，而是模块的强制入口文件，必须放在源码根目录（如 src/main/java/module-info.java），且只能有一个。常见错误包括：

• 把 module-info.java 放在包目录下（比如 src/main/java/com/example/ 里），导致编译器根本找不到它
• 模块名含非法字符（如短横线 -、数字开头），JVM 要求符合 Java 标识符规则，推荐用点分命名（com.example.user）
• requires 写了不存在的模块名，比如 requires com.fasterxml.jackson.core;，但没把 Jackson JAR 放进模块路径，编译时不会报错，运行时才崩
• 导出包路径拼错，比如写了 exports com.example.api;，但实际类在 com.example.service.api，外部模块 import 时会提示 package not visible

正确示例：

module com.example.user {
    requires java.base;
    requires java.sql;
    exports com.example.user.api;
    opens com.example.user.model to com.example.user.test;
}

为什么加了 exports 还是访问不到类

导出（exports）只解决“包可见性”，不等于“所有类都可访问”。真正生效还要看三重过滤：

• 包级可见：必须 exports com.example.api;，否则连包名都解析不了
• 类级可见：类本身得是 public，内部类默认不可见，除非显式声明为 public static
• 成员级可见：方法/字段也得是 public；若要用反射访问非 public 成员，必须用 opens（不是 exports！）

典型误操作：以为 exports com.example.model; 就能让 Spring 自动注入 @Entity 类，结果报 java.lang.IllegalAccessError: class com.example.model.User cannot access its constructor——这是因为 JPA 反射构造实例，而 model 包没被 opens，需改成：opens com.example.model to java.persistence;

模块路径（--module-path）和类路径（-cp）混用会怎样

一旦用了 --module-path，JVM 就进入“模块模式”，此时 -cp 里的 JAR 全部变成自动模块（Automatic Module），名字来自 JAR 文件名（如 jackson-databind-2.15.2.jar → 模块名 jackson.databind），它们能访问所有包，但自身无法被 exports 控制，破坏封装性。

• 后果：你的 com.example.user 模块 requires jackson.databind; 是合法的，但 jackson 作为自动模块，会把所有包暴露给整个模块图，相当于白写了 exports
• 更糟的是：多个同名自动模块（比如两个不同版本的 log4j-core.jar）会导致启动失败，报 ModuleResolutionException: Duplicate module
• 解法：第三方库尽量用模块化版本（如 jackson-bom 提供的模块化 JAR），或用 jlink + jdeps --module 分析依赖树，提前发现冲突

什么时候该用 opens 而不是 exports

opens 不是“导出包”，而是“开放反射入口”。它只在需要运行时深度元数据操作时才用，比如：

• JPA/Hibernate 实体类的字段注入
• JSON 序列化框架（Jackson/Gson）读写私有字段
• 测试框架（JUnit 5）反射调用 @BeforeEach 方法

关键区别：

• exports com.example.api; → 其他模块能 import com.example.api.UserService;
• opens com.example.model; → 其他模块能 User.class.getDeclaredField("id").setAccessible(true);
• opens com.example.model to com.fasterxml.jackson.databind; → 仅对 Jackson 模块开放，其他模块仍不能反射

滥用 opens 等于主动撕开封装边界，生产环境应严格限制范围，宁可改字段为 public 或加 getter/setter，也不无条件 opens 整个包。

模块化不是加个 module-info.java 就完事，真正的难点在于：哪些包该导出、哪些该开放、哪些必须锁死，以及当 Spring、Hibernate、Jackson 这些框架绕过模块检查时，你得比它们更清楚边界在哪。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java模块化系统全面解析》文章吧，也可关注golang学习网公众号了解相关技术文章。