ScopedValue vs ThreadLocal：谁更适合微服务上下文管理

1 前言

1.1 微服务中上下文传递的重要性（如 traceId、用户身份、调用链信息）

在微服务架构中，跨服务调用的上下文管理至关重要。例如：

• 调用链追踪需要 traceId 和 spanId
• 用户身份信息需在多个服务间透传
• 日志、监控等中间件依赖线程上下文信息

这就要求我们有一个安全、高效、可维护的上下文管理机制。

1.2 ThreadLocal 曾经的统治地位

Java 中长期以来使用 ThreadLocal 来实现线程级别的变量隔离。它简单易用，但存在诸多限制，尤其是在异步编程和虚拟线程普及后。

1.3 ScopedValue 的出现及其意义

JDK 20 引入了 java.lang.ScopedValue，作为一种新的线程上下文管理方式，具备自动清理、作用域控制、继承支持等特性，尤其适用于 Project Loom 下的 Virtual Thread 模型。

2 ThreadLocal 简介与典型使用

2.1 ThreadLocal 的基本原理（线程本地变量）

ThreadLocal 是 Java 提供的一种线程绑定变量机制，每个线程拥有自己的独立副本，互不干扰。

private static final ThreadLocal<String> context = new ThreadLocal<>();

context.set("value");
String value = context.get();

2.2 在 Web 应用中的常见用途（如日志上下文、用户信息绑定）

常用于请求上下文存储，例如：

public class RequestContext {
   
    private static final ThreadLocal<String> currentUser = new ThreadLocal<>();

    public static void setCurrentUser(String user) {
   
        currentUser.set(user);
    }

    public static String getCurrentUser() {
   
        return currentUser.get();
    }

    public static void clear() {
   
        currentUser.remove();
    }
}

配合拦截器使用，在请求开始时设置用户，结束时清除。

2.3 示例代码：封装一个基于 ThreadLocal 的上下文工具类

public class ContextHolder {
   
    private static final ThreadLocal<Map<String, Object>> CONTEXT = new ThreadLocal<>();

    public static void set(String key, Object value) {
   
        Map<String, Object> map = CONTEXT.get();
        if (map == null) {
   
            map = new