Java 反射 setAccessible 失败时怎么定位模块边界

遇到 setAccessible(true) 抛出 InaccessibleObjectException，先不要把它当成“反射失效”。Java 模块系统通常已经把原因写在异常里：目标模块、目标包、调用方模块，以及缺少的开放边界。要访问 public API，重点看 exports；要访问 private、package-private 等成员，重点看 opens。两者不是同一个开关。

setAccessible 失败通常缺的是 opens

setAccessible(true) 的目标是压低 Java 语言访问检查。调用方和目标类在同一模块时可以成功；目标包对调用方开放时也可以成功。若只是跨模块调用 public 类型的 public 成员，目标包需要向调用方 exports，并且调用方应读取目标模块。若要越过 private 或默认访问级别，目标包必须对调用方 opens。

因此，只有把 public 写在目标字段或方法上，并不能自动解决问题。模块封装仍然存在；异常中的 does not "opens ..." to ... 往往就是最直接的定位线索。

先打印两个模块，避免改错边界

排查时需要两个对象：被反射的声明类模块，以及执行反射代码的调用方模块。可以把下面的诊断片段临时放在反射入口附近：

Class> target = UserEntity.class;
Module targetModule = target.getModule();
Module callerModule = ReflectionEntry.class.getModule();
String packageName = target.getPackageName();

// 判断调用方能否看到公开 API，以及是否获得深度反射权限
System.out.println("target=" + targetModule.getName());
System.out.println("caller=" + callerModule.getName());
System.out.println("exported=" + targetModule.isExported(packageName, callerModule));
System.out.println("opened=" + targetModule.isOpen(packageName, callerModule));

Field field = target.getDeclaredField("id");
// trySetAccessible 失败只返回 false，适合做可恢复的能力探测
if (!field.trySetAccessible()) {
    throw new IllegalStateException("反射包未对调用方开放：" + packageName);
}

这里的 isExported 和 isOpen 不会替你检查读取关系，它们只是回答包对指定模块的导出或开放状态。诊断结果应和异常中的模块名、包名一起看，不能只看到 exported=true 就认为 private 字段也能访问。

exports 和 opens 应该怎样选择

如果框架只需要读取实体私有字段，优先使用限定的 opens ... to ...，不要为了让一处反射通过就把整个模块声明为 open。若调用方是未命名模块，启动参数的目标通常写成 ALL-UNNAMED。

源码改不了时用精确的 --add-opens

第三方库或临时迁移阶段可以在启动命令中补一条运行时开放：

java --add-opens app.domain/com.example.domain=framework.core \
     -p app.jar:framework.jar \
     -m framework.core/com.example.ReflectionEntry

# app.domain 是目标模块，framework.core 是实际调用方模块

参数格式是“目标模块/目标包=调用方模块”。它只改变这次启动的运行时边界，不会把 exports 写回模块描述符，也不替代正确的 requires。长期方案仍应回到模块声明或框架提供的公开扩展点。

常见问题

exports 能代替 opens 吗？

不能完全代替。exports 面向正常的公开访问；private、默认访问级别等深度反射需要 opens。

为什么加了 --add-exports 仍然失败？

如果失败点是 setAccessible(true) 或私有成员访问，通常需要 --add-opens，而不是只增加导出。

trySetAccessible 和 setAccessible 怎么选？

应用能提供降级路径时用 trySetAccessible 探测更稳妥；必须访问时用 setAccessible(true)，并明确处理 InaccessibleObjectException。

实际修复可以收敛成一张清单：从异常复制目标模块和包名，打印调用方模块，分别检查 isExported 与 isOpen，再用最小范围的 opens 或 --add-opens 验证。这样定位的是模块边界，而不是盲目反复修改反射代码。