Java 9+模块系统默认强封装，setAccessible(true)失效，需用--add-opens显式授权被拦截的模块/包，格式为--add-opens <source-module>/<package>=<target-module>，目标模块通常为ALL-UNNAMED。
这个问题本质是模块系统在拦截——不是反射写错了，而是目标类所在的包没被允许反射穿透。Java 9+ 默认强封装，setAccessible(true) 不再“万能”，必须显式授权。
看异常信息，定位被拦的具体路径
异常堆栈里一定包含类似这样的关键句：
- module java.base does not "opens java.lang" to unnamed module
- module com.example.app does not "opens com.example.entity" to unnamed module
它明确告诉你：哪个模块、哪个包、对哪个调用方（通常是 unnamed module，即传统 classpath 应用）未开放。这是排查起点，不是模糊报错，要逐字读。
确认运行时模块归属
别凭印象猜，用代码验证实际加载来源：
立即学习“Java免费学习笔记（深入）”；
- 打印注解类的模块：
MyAnnotation.class.getModule().getName() - 打印该注解所在包名：
MyAnnotation.class.getPackage().getName() - 如果注解来自 JDK（如
@FunctionalInterface），它属于java.base；若来自第三方 jar 且已模块化（如 Jackson 2.15+），可能属于com.fasterxml.jackson.annotation模块
按需配置 --add-opens
JVM 启动参数必须精确匹配异常提示的模块/包结构，格式为：
--add-opens <source-module>/<package>=<target-module>常见正确写法：
- 解决 JDK 内部注解（如
sun.misc.Contended）：--add-opens java.base/sun.misc=ALL-UNNAMED - 解决自定义模块中私有包的注解：
--add-opens com.myapp/com.myapp.annotation=ALL-UNNAMED - 若应用是传统 classpath（非模块化 jar），目标模块统一用
ALL-UNNAMED；若双方都是命名模块，需写具体模块名
注意：--add-opens java.base/all-unnamed 是无效的，必须带包路径；ALL-UNNAMED 全大写，不能写成 all-unnamed。
优先考虑不依赖反射的替代方案
模块系统限制不是 bug，而是提醒你设计更健壮：
- 用标准元注解（如
@Retention(RetentionPolicy.RUNTIME)）确保注解可被反射读取，而非依赖字段级反射 - 避免直接读取
private final字段存储的注解值；改用公开 getter 或构造器传入 - 框架场景（如 Spring、Hibernate）升级到支持 JPMS 的版本，它们内部已适配
--add-opens或改用服务发现机制
硬开模块权限是临时解法，长期应减少对非导出 API 的隐式依赖。
