静态块不适合初始化MDC变量，因其在类加载时由主线程执行，无法绑定请求线程，导致traceId写入错误上下文、无法透传Header值、无法清理而引发线程池脏数据。
静态块不能用于实战实现全局日志上下文变量（如 traceId）的初始化与 MDC 标记配置——因为它在类加载时执行，早于请求线程启动，且无法绑定到具体请求生命周期，强行使用会导致严重问题。
为什么静态块不适合初始化 MDC 变量
静态块属于类级别初始化，只执行一次，运行在主线程（如 Tomcat 启动线程），而非业务请求线程。MDC 依赖 ThreadLocal 实现线程隔离，而静态块中调用 MDC.put("traceId", ...) 会把 traceId 写入启动线程的上下文，对后续所有请求无效，甚至污染日志输出（例如所有日志都显示同一个 traceId 或空值）。
- traceId 必须按请求粒度生成，每个 HTTP 请求/任务需唯一
- MDC.put() 必须在请求所在线程中执行，否则上下文不生效
- 静态块无 request/response 对象，无法获取 Header 中透传的 traceId
- 无法配套执行清理（
MDC.remove()或MDC.clear()），极易引发线程复用脏数据（尤其在 Tomcat 线程池中）
真正可行的初始化时机：请求入口处
必须在每次请求开始时、业务逻辑执行前完成 MDC 设置，并在请求结束时清除。推荐位置包括：
- Filter（Servlet 容器）：适用于所有 Web 请求，可统一拦截并处理 Header 透传
- Spring Interceptor：适合 Spring MVC 项目，能访问 HandlerMethod 和 Model
- WebMvcConfigurer + HandlerInterceptor：便于条件化启用（如仅生产环境）
- 全局 AOP 切面（@Around）：适合非 Web 场景（如 RPC 入口、定时任务）
正确配置示例（Filter 方式）
以下为 Spring Boot 中标准 Filter 实现，兼顾透传与自动生成：
@WebFilter(urlPatterns = "/*")
public class TraceIdFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest httpRequest = (HttpServletRequest) request;
String traceId = httpRequest.getHeader("X-TraceId");
if (traceId == null || traceId.trim().isEmpty()) {
traceId = UUID.randomUUID().toString().replace("-", "");
}
// ✅ 绑定到当前请求线程
MDC.put("traceId", traceId);
try {
chain.doFilter(request, response);
} finally {
// ✅ 必须清理，防止线程复用污染
MDC.remove("traceId");
}
}
}
Logback 日志格式关键配置
确保 logback-spring.xml 中使用
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><layout class="ch.qos.logback.classic.PatternLayout"><pattern>%d{HH:mm:ss.SSS} [%X{traceId:-N/A}] [%thread] %-5level %logger{36} - %msg%n</pattern></layout></appender>
-
%X{traceId:-N/A}表示 traceId 不存在时显示 N/A，避免日志字段错位 - 必须指定
class="ch.qos.logback.classic.PatternLayout"，否则%X{}不生效 - 切勿将 pattern 写在
