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;