在 java 日志记录中,将用户 id 放入 mdc(mapped diagnostic context)的标准做法是在请求处理的入口处调用 mdc.put("userid", userid)。这会将用户 id 绑定到当前线程的上下文中,使得后续所有通过 logback 或 log4j2 输出的日志都自动携带该 id。为了确保数据隔离和内存安全,必须在处理结束或异常发生时显式调用 mdc.clear() 或 mdc.remove("userid") 清理上下文。

如何在 Web 请求的生命周期中正确设置和清理 MDC?
在 Spring Boot 等 Web 框架中,最可靠的方式是使用 HandlerInterceptor 或 Filter 来管理 MDC 的生命周期。拦截器可以在请求进入 Controller 之前获取用户身份并放入 MDC,并在请求结束后执行清理操作。这种方式保证了无论业务逻辑如何复杂,只要请求经过拦截器,MDC 就能被正确维护,避免线程复用导致的日志污染。

import org.slf4j.MDC;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
@Component
public class MdcInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response,
Object handler) throws Exception {
// 模拟从 Token 或 Session 中获取用户 ID
String userId = request.getHeader("X-User-Id");
if (userId != null) {
MDC.put("userId", userId);
}
return true;
}
@Override
public void afterCompletion(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response,
Object handler, Exception ex) throws Exception {
// 必须清理,防止线程池复用导致数据串扰
MDC.clear();
}
}
上述代码定义了一个拦截器,在 preHandle 阶段提取 X-User-Id 头并存入 MDC。在 afterCompletion 阶段,无论请求成功与否,都会调用 MDC.clear() 清空当前线程的 MDC 数据。这是防止内存泄漏和日志错误关联的关键步骤。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
异步线程中如何传递 MDC 中的用户 ID?
当业务逻辑涉及异步执行(如使用 @Async 或自定义线程池)时,子线程无法自动继承父线程的 MDC 数据。如果直接提交任务,子线程的日志中将不会包含用户 ID。为了解决这个问题,需要包装 Runnable 或 Callable,在子线程启动前手动读取父线程的 MDC 值,并在子线程结束时恢复或清理。

import org.slf4j.MDC;
import java.util.Map;
import java.util.concurrent.Callable;
public class MdcTaskWrapper implements Runnable {
private final Runnable task;
private final Map<String, String> contextMap;
public MdcTaskWrapper(Runnable task) {
this.task = task;
// 捕获当前线程(父线程)的 MDC 上下文
this.contextMap = MDC.getCopyOfContextMap();
}
@Override
public void run() {
try {
// 将父线程的上下文应用到子线程
if (contextMap != null) {
MDC.setContextMap(contextMap);
}
task.run();
} finally {
// 子线程结束时必须清理,避免线程池污染
MDC.clear();
}
}
}
这段代码展示了如何包装一个 Runnable。在构造函数中,它通过 MDC.getCopyOfContextMap() 保存父线程的上下文快照。在 run 方法中,它先通过 MDC.setContextMap() 将快照恢复到当前子线程,确保子线程中的日志能带上用户 ID。最后,在 finally 块中调用 MDC.clear(),确保子线程归还给线程池时上下文是干净的。
如果未找到用户 ID,MDC 的行为会有什么影响?
如果在请求入口未能解析出用户 ID(例如匿名访问或 Token 无效),MDC.put 可能不会被调用,或者被设置为空字符串。此时,日志模式中若配置了 %X{userId},输出将为空或显示默认占位符。这不会影响程序运行,但会导致日志追踪断裂。建议在日志模式中使用默认值语法,如 %X{userId:-anonymous},这样在未设置时会自动显示 "anonymous",便于区分已登录和未登录用户的日志流。

















