Java模块化下注解反射需用opens而非exports，setAccessible(true)失效，须按JDK版本分支处理并运行时验证。
Java 模块化系统（JPMS）引入后，注解与反射的兼容性问题集中爆发——不是代码写错了，而是模块封装机制默认阻止了运行时对注解元数据的深度访问。关键不在反射怎么写，而在模块是否“开门放行”。
必须用 opens，不能只靠 exports
exports 只控制 public 类型的编译期可见性，对反射读取注解完全无效。真正起作用的是 opens 声明：
- 若注解定义在
com.example.api包中，且外部模块要通过method.getAnnotation(MyAnno.class)读取，就得在module-info.java中写：opens com.example.api to java.base; - 若调用方是 Spring Boot 应用（模块名
org.springframework.core），则应写：opens com.example.api to org.springframework.core; - 测试阶段常用宽松写法：
opens com.example.api to ALL-UNNAMED;（适配 classpath 启动的 JUnit 4/5 或直接运行的工具）
setAccessible(true) 在模块化下失效
这段代码在 JDK 8 能跑通，但在 JDK 9+ 会抛 InaccessibleObjectException：
method.setAccessible(true); // 无效！模块层封装优先级更高
立即学习“Java免费学习笔记（深入）”；
它无法绕过 JPMS 的访问限制。即使你加了这行，只要模块没 opens 对应包，反射仍失败。这不是 bug，是设计使然。
按 JDK 版本做兼容性兜底
混合微服务中常有 JDK 8 和 JDK 17 并存，需统一行为：
- 所有跨模块共享的注解，强制使用
@Retention(RetentionPolicy.RUNTIME)；CLASS级注解在高版本默认不可见 - 自研反射工具类中做版本分支处理：
• JDK < 9：直接调用getAnnotation()
• JDK ≥ 9：先尝试setAccessible(true)，捕获InaccessibleObjectException后退回到遍历getDeclaredAnnotations() - 避免读取 JDK 内部注解（如
@sun.misc.Contended），改用标准 JSR 或 Jakarta 注解
验证是否真正生效
光改 module-info.java 不代表成功，得运行时确认：
- 启动 JVM 时加参数：
--illegal-access=debug，看日志是否打印“opens not allowed”类提示 - 捕获异常类型：
if (e instanceof InaccessibleObjectException)，说明是模块权限问题 - 运行时检查：
ModuleLayer.boot().findModule("java.base").get().getDescriptor().opens()，确认目标包确实在开放列表中
