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;
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
模块路径（--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 这些框架绕过模块检查时，你得比它们更清楚边界在哪。
