MDC.put("traceId", tid);
try { handle(); } finally { MDC.clear(); }
排查一次下单失败，网关、订单、库存、支付各写各的文件，只有网关那条带 traceId，其余五处都只有订单号，grep 一次只能捞到一段。先别急着动参数，把报错原文和时间点记下来，顺序反了容易白折腾。
原因不复杂，traceId 放在入口的局部变量里，没有写进 MDC，也没有通过 RPC 透传。线程池复用后 MDC 还会残留上一个请求的值。
「日志链路串联」确认了原因之后，改动尽量只碰那一处，顺手改的东西后面最容易出问题。备份不是备了就行，恢复一次才算数，很多备份文件打开才发现是空的。
接口问题先分清是没发出去、发出去了没收到，还是收到了处理失败。偶发问题先统计频率，一小时几次和一天一次，查法完全不同。
改完顺手把文档补一句，省得下次自己重新推一遍。
处理上按这个顺序：入口生成 traceId 后放进 MDC；RPC 调用把 traceId 放进 header 下游继续放 MDC；线程池提交任务时复制 MDC 用完清理；日志 pattern 统一加 %X{traceId}。
改完只确认一件事：用 traceId 一次检索能拿到完整六段日志 顺序正确。