ThreadLocal 与责任链模式结合，本质是用 ThreadLocal 承载“当前线程的上下文数据”，让整条责任链上的 Handler 无需显式传参即可安全访问同一份业务上下文。
ThreadLocal 和责任链模式结合，本质是用 ThreadLocal 承载“当前线程的上下文数据”，让整条责任链上的 Handler（处理器）无需显式传参就能安全访问同一份业务上下文。这种组合在 Netty、Spring WebFlux 拦截器链、自定义网关过滤器链等场景中非常典型。
为什么适合搭配责任链？
责任链是一串顺序执行（或条件跳转）的处理器，每个 Handler 只关心自己那部分逻辑，比如鉴权 → 日志 → 限流 → 业务处理。如果每次调用都靠方法参数层层透传用户 ID、traceId、租户信息等，代码冗长且易出错。而 ThreadLocal 提供了天然的“线程内单例上下文”能力——只要链路始终在同一线程内执行，所有 Handler 都能通过同一个 ThreadLocal 实例 get() 到最新状态，无需修改接口签名。
实际落地的关键设计点
核心不是“能不能用”，而是“怎么用得稳”。重点注意三点：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 上下文对象要可变且线程安全：推荐封装成一个不可变的 Context 类（如 RequestContext），但内部字段用 final + 构造注入；若需中途修改（如添加日志字段），提供 withXxx() 方法返回新实例，并通过 ThreadLocal.set() 更新。避免直接暴露可变字段引发并发写冲突。
- 责任链入口统一初始化：在链路起点（如 Netty 的 ChannelHandler#channelRead 或 Spring 的 Filter#doFilter）中完成 ThreadLocal.set()。例如解析完 token 后，把 userId、tenantId、requestId 封装进 RequestContext，再 set 进去。后续所有 Handler 都只 get，不重复解析。
- 出口必须清理：链路结束时（如 response 写出后、或异常捕获块末尾），务必调用 ThreadLocal.remove()。否则在线程池复用场景下，残留的旧上下文会污染下一个请求，造成数据串号或 NPE。
Netty 中的经典参考结构
Netty 的 ChannelPipeline 就是责任链的教科书实现。它本身不依赖 ThreadLocal，但业务开发常在其 Handler 中叠加上下文管理：
立即学习“Java免费学习笔记（深入）”；
- 定义 RequestContext 类，包含 traceId、userId、startTime 等字段；
- 定义 static final ThreadLocal<RequestContext> CONTEXT_HOLDER = ThreadLocal.withInitial(() -> null);；
- 首节点 AuthHandler 解析 header 后构造 RequestContext 并 set；
- 中间节点 LogHandler、MetricHandler 直接 get() 使用；
- 末节点 ResponseHandler 发送完响应后 remove()。
注意线程切换带来的断层
责任链若涉及异步（如 submit 到线程池、调用 CompletableFuture.runAsync），ThreadLocal 会失效。此时不能硬扛，必须主动传递：
- 用 TransmittableThreadLocal 替换原生 ThreadLocal，它能自动将上下文从父线程透传到线程池中的子线程；
- 或在提交任务前手动 capture 上下文，在子线程 run() 开头 restore，结尾 remove —— TTL 库已帮你封装好这套逻辑，比手写更可靠。
