JDK17反射操作ThreadLocal遇模块访问异常的原因与替代方案咨询

使用反射获取当前ThreadLocal的值时，抛出如下异常：

Exception in thread "main" java.lang.reflect.InaccessibleObjectException: Unable to make field java.lang.ThreadLocal$ThreadLocalMap java.lang.Thread.threadLocals accessible: module java.base does not "opens java.lang" to unnamed module @327471b5
    at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:354)
    at java.base/java.lang.reflect.AccessibleObject.checkCanSetAccessible(AccessibleObject.java:297)
    at java.base/java.lang.reflect.Field.checkCanSetAccessible(Field.java:178)
    at java.base/java.lang.reflect.Field.setAccessible(Field.java:172)
    at com.moan.message.base.remote.service.helper.TT.main(TT.java:19)

添加以下JVM启动参数后异常解决：

--add-opens
java.base/java.lang=ALL-UNNAMED
--add-opens
java.base/java.lang.ref=ALL-UNNAMED

环境信息：

java version "17.0.3" 2022-04-19 LTS
Java(TM) SE Runtime Environment (build 17.0.3+8-LTS-111)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.3+8-LTS-111, mixed mode, sharing)

测试代码：

public class TT {
    public static void main(String[] args) throws Exception {
        Thread thread = Thread.currentThread();
        Field threadLocalsField = Thread.class.getDeclaredField("threadLocals");
        threadLocalsField.setAccessible(true);
        Object threadLocals = threadLocalsField.get(thread);
        System.out.println(threadLocals);
    }
}

疑问解答 #

1. 为何自定义对象（如下代码）使用反射时不会报错？ #

public class Record implements Serializable {
    private String name;
    // ....
}

这是Java 9引入的**模块系统（JPMS）**访问控制规则导致的：

• JDK核心类（比如java.lang.Thread）属于java.base模块，该模块默认封装内部私有/包级成员，仅对模块内或明确授权的外部模块开放反射访问权限。
• 自定义的Record类属于未命名模块（unnamed module）——所有未加入显式模块的代码都默认归属于这个模块。模块系统为兼容旧代码，对未命名模块的成员做了宽松处理：即使是私有字段，只要通过setAccessible(true)开启反射访问，就能正常读取/修改，不受模块封装限制。

2. 除了添加JVM启动参数外，还有其他解决方法吗？ #

有几种可选方案，但各有局限性：

• 将自身代码转为显式模块：在项目中添加module-info.java声明自己的模块，启动时针对该模块开放java.base的包权限，例如：

  --add-opens java.base/java.lang=你的模块名
  --add-opens java.base/java.lang.ref=你的模块名
  

  这种方式比开放给所有未命名模块更安全，但需要掌握模块系统的基础用法。
• 避免直接反射JDK内部字段：如果目标ThreadLocal是自己维护的，直接调用ThreadLocal.get()就能获取值，完全不需要反射；如果是第三方库的ThreadLocal，除非有合法调试/监控需求，否则不建议通过反射访问——这属于依赖内部实现，后续JDK版本更新可能导致代码失效。
• 使用Java Agent动态开放权限：编写Java Agent，在程序启动时通过Instrumentation和Module API动态修改java.base模块的访问规则，将java.lang等包开放给你的代码。这种方式无需修改启动参数，但实现复杂度较高，适合自动化部署场景。
• 慎用内部API（不推荐）：比如通过sun.misc.Unsafe绕过访问控制，但这类API属于JDK内部实现，无官方兼容性保证，Java 9后被严格限制，未来版本可能被移除。

内容的提问来源于stack exchange，提问作者xiaoming wang