Java中用MDC实现用户行为追踪的核心是将userId等标识绑定到线程上下文并自动注入日志，需在请求入口（如拦截器）注入、finally清除、异步场景透传（TTL/自定义线程池）、日志格式引用%X{userId}，并推荐与traceId协同使用。

Java 中用 MDC 实现用户行为追踪，核心是把用户标识（比如 userId、username）绑定到当前线程上下文中，并让所有该线程产生的日志自动带上这个标识。这样查日志时，只要过滤某个 userId，就能串起他所有的操作记录。

在请求入口处注入用户信息

通常在 Spring Boot 的拦截器或过滤器里完成。比如用户登录后，token 解析出 userId，就把它塞进 MDC：

• 使用 MDC.put("userId", userId) 存入用户 ID
• 如果还有其他关键字段（如 tenantId、clientIp），也可以一并 put 进去
• 务必在 finally 块或 try-with-resources 结尾调用 MDC.clear()，避免线程复用导致脏数据

确保异步场景不丢上下文

Spring 中的 @Async、CompletableFuture 或线程池任务会开启新线程，MDC 默认不会传递过去。解决办法有几种：

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• 用 Logback 的 AsyncAppender 不影响 MDC，它只是异步输出，上下文仍在原线程
• 自定义线程池：包装 ThreadPoolTaskExecutor，重写 execute() 方法，在提交前把当前 MDC 拷贝过去
• 使用 TransmittableThreadLocal 替代原生 ThreadLocal（需引入 TTL 库），能自动透传 MDC 数据

日志格式中显式引用 MDC 字段

在 logback-spring.xml 的 pattern 里直接写 %X{userId}，就能把 MDC 中的值打印出来：

立即学习“Java免费学习笔记（深入）”；

• 例如：%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %X{userId} - %msg%n
• 推荐搭配 JSON 格式输出（用 logstash-encoder），方便 ELK 或 Loki 按 userId 聚合分析
• 避免只打 username，优先用不可变、唯一、无敏感信息的 userId 或 uuid

与全链路 traceId 协同使用

用户行为不是孤立的，常要和请求链路一起看。可以把 traceId 和 userId 同时放进 MDC：

• Filter 中生成 traceId 并 MDC.put("traceId", id)
• 再通过认证逻辑获取 userId，MDC.put("userId", uid)
• 日志里同时输出 %X{traceId} 和 %X{userId}，排查时既能按链路找全流程，也能按用户查全操作