module-info.java 是模块强制入口文件,须置于源码根目录且命名规范;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)只解决“包可见性”,不等于“所有类都可访问”。真正生效还要看三重过滤:
立即学习“Java免费学习笔记(深入)”;
-
包级可见:必须
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 这些框架绕过模块检查时,你得比它们更清楚边界在哪。









