java全链路日志追踪的核心是通过trace id贯穿请求全流程。1. 用mdc在单线程绑定/输出trace id；2. 跨线程需手动传递或用ttl；3. 微服务间通过http/rpc协议头透传；4. 推荐集成sleuth或skywalking等apm工具实现自动注入与日志关联。
Java 全链路日志追踪的核心是让一次请求经过的所有服务节点（如网关、微服务、DB、RPC 调用等）共享同一个唯一标识（Trace ID），并在每条日志中自动携带该标识，从而支持跨服务、跨线程、跨进程的日志串联与问题定位。
1. 使用 MDC 传递 Trace ID
MDC（Mapped Diagnostic Context）是 SLF4J 提供的线程级日志上下文工具，适合在单个线程内绑定和透传追踪 ID。
- 在请求入口（如 Spring MVC 的拦截器或 Filter）生成唯一 Trace ID（如 UUID 或雪花 ID），并放入 MDC：
MDC.put("traceId", traceId) - 确保日志 pattern 中包含
%X{traceId}（Logback 示例）：%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %X{traceId} - %msg%n - 请求结束时调用
MDC.clear()，避免线程复用导致 ID 泄露
2. 跨线程传递需显式处理
MDC 默认不继承子线程，使用线程池或异步操作（如 CompletableFuture、@Async）时需手动传递上下文。
- 封装带上下文的线程池：继承
ThreadPoolTaskExecutor，重写execute()和submit()，在执行前将父线程 MDC 拷贝到子线程 - 使用
TransmittableThreadLocal（阿里 TTL 库）替代原生InheritableThreadLocal，它能穿透线程池、异步框架等场景 - 对于
CompletableFuture，推荐用CompletableFuture.supplyAsync(() -> ..., executor)并配合自定义 executor，避免使用无参版本（无法控制上下文）
3. 微服务间透传需结合 RPC 协议
Trace ID 必须随 HTTP 或 RPC 请求头向下游服务传递，下游服务再将其还原到 MDC。
- HTTP 场景：在 Feign/RestTemplate 拦截器中读取当前 MDC 的 traceId，添加到请求头（如
X-Trace-ID）；在 Spring Boot 的OncePerRequestFilter中从请求头提取并写入 MDC - Dubbo 场景：实现
org.apache.dubbo.rpc.Filter，通过invoker.getUrl().getParameter("traceId")或隐式传参（RpcContext.getServerAttachment()）完成透传 - gRPC 场景：使用
ClientInterceptor和ServerInterceptor在Metadata中存取 traceId
4. 推荐集成成熟方案（如 SkyWalking / Sleuth + Zipkin）
手写链路追踪易出错且功能有限，生产环境建议基于成熟 APM 工具构建。
- Spring Cloud Sleuth 自动注入
traceId和spanId到 MDC，并兼容 Zipkin 上报；只需引入spring-cloud-starter-sleuth，日志自动包含[service-name,traceId,spanId,exportable] - Apache SkyWalking 提供 Java Agent 零侵入接入，自动采集 trace、metrics、logs，并支持日志关联（需配置 logback-appender 或 log4j2-appender 将 traceId 注入日志）
- 关键点：无论用哪种方案，都要统一日志格式中的 trace 字段名（如都用
traceId），并与 APM 后端字段对齐，才能实现日志与链路图联动查询
不复杂但容易忽略的是上下文清理和跨线程一致性。只要 traceId 能稳定贯穿请求生命周期，并在每条日志中稳定输出，再配合 APM 可视化，全链路排查就真正落地了。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
