最根本的解决方式是在目标模块的module-info.java中用opens声明开放对应包，如opens com.example.target.internal to com.example.reflector；反射前仍需调用setaccessible(true)，且不可依赖--add-opens替代模块设计。
在 Java 模块化（JPMS）项目中，反射访问私有成员（如私有字段、方法）默认会失败，并抛出 IllegalAccessException 或 InaccessibleObjectException，这是因为模块系统加强了封装——即使用了 setAccessible(true)，若目标类所在模块未对反射调用方“开放”（open）对应包，JVM 仍会拒绝访问。
确保目标模块显式开放（open）对应包
这是最根本的解决方式。被反射访问的私有成员必须位于一个被 open 的包中（或整个模块被 open module），且该开放需明确指向调用反射的模块（或 ALL-UNNAMED，适用于传统类路径代码）。
- 在被访问类所在的模块的
module-info.java中，使用opens声明：
module com.example.target {
// 允许 com.example.reflector 模块反射访问 internal 包（含私有成员）
opens com.example.target.internal to com.example.reflector;
// 或开放给所有模块（不推荐，降低封装性）：
// opens com.example.target.internal;
// 或整个模块开放（更宽松，仅测试/框架场景考虑）：
// open module com.example.target;
}
- 如果反射代码在 unnamed module（比如通过
-cp启动的旧式代码），可写成：opens com.example.target.internal to ALL-UNNAMED; -
opens仅影响运行时反射（setAccessible(true)），不影响编译期访问控制。
反射调用前正确设置可访问性
即使模块已开放，仍需在反射操作中显式调用 setAccessible(true)，且必须在获取成员对象后、首次调用前执行。
- 正确顺序示例（访问私有字段）：
Field field = targetClass.getDeclaredField("privateField");
field.setAccessible(true); // ✅ 必须在 get() / set() 前调用
Object value = field.get(instance); // 不再抛 InaccessibleObjectException
- 对私有方法同理：
method.setAccessible(true); method.invoke(obj, args); - 注意：Java 12+ 对重复调用
setAccessible(true)更严格，建议只调一次，避免冗余。
避免常见误区
-
不要依赖
--add-opens替代模块声明：虽然 JVM 参数--add-opens java.base/java.lang=ALL-UNNAMED可临时绕过限制，但它属于外部强制干预，破坏模块契约，不应作为生产方案；应优先通过module-info.java正确建模依赖与开放关系。 -
非运行时模块（如编译期）不检查 opens：
opens是运行时概念，javac 不验证它是否匹配反射行为，错误只在运行时暴露。 -
模块名必须完全匹配：
opens pkg to com.example.reflector中的com.example.reflector必须与调用方模块的module-info.java中声明的module com.example.reflector { ... }一致。
调试技巧：快速定位模块访问问题
当仍遇到 InaccessibleObjectException，可通过以下方式排查：
- 确认异常栈中提示的类是否属于某命名模块（
clazz.getModule().isNamed()）； - 打印目标模块的开放信息：
targetClass.getModule().getDescriptor().opens()； - 检查调用方模块是否被目标模块的
opens ... to明确列出； - 使用
jdeps --list-deps和jmod list辅助分析模块依赖与内容。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
