说起来，

前言

在并发编程中。ThreadLocal 是常用但往往让人头疼的工具。不过，它会导致线程泄露、内存膨胀。且在使用时需要显式绑定与解绑，代码冗长、易错。ScopedValue 在 JDK21 作为预览特性出现，旨在提供更安全、更轻量的线程局部状态管理方案。下面让我们聚焦 JDK24/25 的更新，看它们如何解决实际问题还有带来的新特性。老实说，

JDK24 调整：简化 API 与提高可读性

痛点： - 之前的 .runWhere/.callWhere 两个方法命名不统一。导致学习成本上升，- 需要手动调用多层方法才能完成绑定与执行，阅读流畅度下降。

改动：

• 移除了 .runWhere/.callWhere。
• 统一使用单一的 .where 方法完成值绑定与代码块执行。

示例

public class ScopedValueDemo {
private static final ScopedValue STRING_SCOPED_VALUE = ScopedValue.newInstance;public static void main {
// 使用 where 一行完成绑定与执行
ScopedValue.where).run -> {
System.out.println);})，}
public static String say {
System.out.println方法");return "aaa";}
}

输出结果：

"============say方法"
"aaa"

JDK25 调整：正式转正 + 更严格的参数校验

痛点： - 预览阶段对 API 的使用不确定性让团队难以投产。- 对于默认值的处理缺乏严格性，传入 null 会导致意外行为。

A. 正式转正

• Coding 场景更稳定，可直接在生产环境使用。
• Maven/Gradle 配置更简洁，无需额外开启 preview flag。

B. orElse 方法不再接受 null 参数

• Avoids accidental null propagation which could mask bugs.
• If you need a default value of null,use explicit check or overload.

示例— 多场景演示或Else 的正确用法：

import java.lang.ScopedValue;public class ScopedValueOrElseExample {
private static final ScopedValue USER_ID = ScopedValue.newInstance;public static void main {
// 场景1：未绑定值时使用 orElse 提供默认值
String userId1 = USER_ID.orElse;System.out.println;// 输出：aaaa
// 场景2：绑定值后orElse 会返回绑定值
ScopedValue.where.run -> {
String userId2 = USER_ID.orElse;System.out.println;// 输出：hello world
});// 场景3：在子方法中使用 orElse
printUserId;}
private static void printUserId {
// 子方法中未绑定值，使用默认值
String userId = USER_ID.orElse;System.out.println;// 输出：unknown_user
}
}

说到未绑定值时，aaaa
再看绑定值后，hello world
从子方法中来看。unknown_user

& 实际使用建议

• ScopedValue 完全可替代 ThreadLocal：The same semantics but safer and lighter weight.
• 推荐场景：a) 请求级业务数据；b) 日志上下文，c) RPC 链路追踪 ID 等需要跨线程但不想污染全局状态的场合。
• 编码要点：a) 使用 .where.run 简洁链式写法；b) 避免 .orElse，改为显式空检查或自定义默认字符串。
• 注意事项：a) 当你需要把同一个 scoped value 注入多层调用链时只需一次 .where 即可；b) 若你仍然担心旧版本兼容，可保持对 .runWhere/.callWhere 的回退实现。但建议迁移到最新 API，以获得更好性能和安全保障。
• Aiming for cleaner concurrency code is no longer a future dream—since JDK25 it’s a stable feature you can confidently use in production.