在 java 中，异常日志携带 mdc 的 traceid 和 spanid 的关键是确保日志记录时 mdc 上下文有效：需在请求入口处注入 mdc（如 sleuth 自动或手动设置），日志必须在原线程中执行（避免异步丢失），并配置日志 pattern 支持 %x{traceid} 等占位符。
在 Java 中，当使用 throw 抛出异常时，若想在日志中自动携带 MDC（Mapped Diagnostic Context）中的 traceId 和 spanId，关键不是“在 throw 时写入”，而是确保异常被记录（log）的那一刻，MDC 上下文仍然有效且已正确设置。
确保 MDC 在异常发生前已注入
MDC 是线程绑定的，它的值只对当前线程可见。因此，必须在业务逻辑执行前（例如 Web 请求进入、消息消费开始等入口处），就将链路追踪 ID 注入 MDC：
- Spring Cloud Sleuth 或 Micrometer Tracing 会自动完成该操作（如通过
TraceFilter/TracingWebFilter），无需手动干预 - 若自建链路追踪（如基于 OpenTracing/OpenTelemetry），需在拦截器或 AOP 中调用：
MDC.put("traceId", tracer.currentSpan().context().traceId());MDC.put("spanId", tracer.currentSpan().context().spanId());
异常日志必须在同一线程中打印
throw 本身不触发日志；真正写日志的是 catch 块或全局异常处理器（如 @ControllerAdvice）。只要这些日志语句发生在原请求线程中，MDC 就自然生效：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- ✅ 正确示例（同步处理）：
try { doSomething(); } catch (Exception e) { log.error("业务执行失败", e); throw e; }
此时log.error能取到 MDC 中的 traceId/spanId - ❌ 错误示例（异步丢失上下文）：
CompletableFuture.runAsync(() -> log.error("异步日志", e));
此时子线程未继承 MDC，需显式传递（如用ThreadLocal拷贝或借助 Sleuth 的LazyTraceExecutor）
使用支持 MDC 的日志框架和 Pattern
确保日志配置中 pattern 包含 MDC 字段，例如 Logback 的 logback-spring.xml：
- 添加占位符：
%X{traceId:-} %X{spanId:-}（-表示为空时不输出） - 完整示例 pattern：
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level [%X{traceId:-},%X{spanId:-}] %logger{36} - %msg%n
全局异常处理器中保持 MDC 不丢失
在 @RestControllerAdvice 中统一处理异常时，要确认它运行在原始请求线程（Spring 默认是），并避免在 handler 内部新开线程或清空 MDC：
- 不要在 handler 中调用
MDC.clear() - 若需异步上报错误，应先读取 MDC 值并作为参数传入：
String traceId = MDC.get("traceId");<br> errorReportService.asyncReport(e, traceId);
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
