电商系统实战：ThreadLocal在分布式追踪中的妙用
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
构建一个Spring Boot电商微服务demo，包含：1) 使用ThreadLocal存储MDC日志追踪ID 2) 通过Feign拦截器实现跨服务ID传递 3) 集成Sleuth+Zipkin可视化追踪。要求：- 展示HTTP请求全链路ID一致性 - 提供线程池场景的解决方案 - 包含Swagger测试接口- 点击'项目生成'按钮，等待项目生成完整后预览效果
在电商系统的开发过程中，全链路追踪是一个非常重要的功能。尤其是在微服务架构下，一个用户请求可能会经过多个服务的处理，如何保证这些服务之间的调用能够被完整地追踪到，是系统可观测性的关键。最近我在一个Spring Cloud电商项目中，就遇到了这样的需求，通过使用ThreadLocal实现了全链路追踪ID的传递，效果很不错，这里分享一下具体实现方案。
- 理解ThreadLocal的基本原理
ThreadLocal是Java中一个非常有用的工具类，它能够为每个线程提供一个独立的变量副本。这意味着，不同线程访问同一个ThreadLocal变量时，实际上访问的是各自线程内的副本，互不干扰。这个特性非常适合用来存储与当前请求相关的上下文信息，比如追踪ID。
- 创建TraceId上下文工具类
首先我创建了一个TraceContext工具类，内部使用ThreadLocal来存储追踪ID。这个类提供了三个核心方法：设置追踪ID、获取当前追踪ID、清除追踪ID。在Spring Boot应用中，我们通常会在过滤器或拦截器中调用这些方法。
- 实现请求拦截器
为了自动处理追踪ID，我实现了一个Servlet过滤器。这个过滤器会在请求到达时生成一个新的追踪ID（如果请求头中没有携带的话），并将其设置到TraceContext中。在请求处理完成后，过滤器会负责清理ThreadLocal中的内容，防止内存泄漏。
- 集成MDC日志框架
为了让日志系统能够自动记录追踪ID，我将TraceContext中的ID设置到了MDC（Mapped Diagnostic Context）中。这样，在日志配置中就可以通过%X{traceId}来输出追踪ID，所有日志都会自动带上这个标识，方便后续查询和分析。
- 处理Feign客户端调用
在微服务架构下，服务间调用是通过Feign客户端完成的。为了保证追踪ID能够跨服务传递，我实现了一个Feign请求拦截器。这个拦截器会从TraceContext中获取当前追踪ID，并将其添加到请求头中。这样当下游服务收到请求时，就能获取到相同的追踪ID。
- 线程池场景的特殊处理
在电商系统中，很多操作会使用线程池来异步执行。这时候就需要特别注意，因为ThreadLocal的值不会自动传递给子线程。我的解决方案是，在提交任务到线程池时，先将当前TraceContext的值保存下来，然后在子线程中手动恢复。
- 集成Sleuth和Zipkin
虽然我们实现了基本的追踪功能，但为了获得更强大的可视化能力，我进一步集成了Spring Cloud Sleuth和Zipkin。Sleuth会自动处理追踪ID的生成和传递，与我们的实现完美配合。Zipkin则提供了直观的调用链展示，方便排查问题。
- 测试验证
最后，我使用Swagger创建了几个测试接口，模拟用户下单流程。通过观察日志和Zipkin界面，确认追踪ID确实能够在各个服务间正确传递，整个调用链清晰可见。
通过这次实践，我深刻体会到ThreadLocal在分布式系统中的价值。它不仅解决了追踪ID传递的问题，还能应用于用户会话、权限信息等各种需要线程隔离的场景。当然，使用时也要注意及时清理，避免内存泄漏。
如果你也想快速体验这种全链路追踪的实现，可以试试InsCode(快马)平台。我在上面部署了这个电商demo，一键就能运行，还能直接修改代码进行实验。平台内置了完整的开发环境，不需要配置任何东西，特别适合快速验证技术方案。实际使用下来，从代码编写到部署上线的过程非常流畅，省去了很多环境搭建的麻烦。
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
构建一个Spring Boot电商微服务demo，包含：1) 使用ThreadLocal存储MDC日志追踪ID 2) 通过Feign拦截器实现跨服务ID传递 3) 集成Sleuth+Zipkin可视化追踪。要求：- 展示HTTP请求全链路ID一致性 - 提供线程池场景的解决方案 - 包含Swagger测试接口- 点击'项目生成'按钮，等待项目生成完整后预览效果