可以在 synchronized 代码块内安全使用 MDC 绑定用户流水号，因其基于 ThreadLocal、与线程强绑定；需在同步前 put、同步后 finally clear，避免线程复用导致脏数据。
在 synchronized 代码块内使用 MDC（Mapped Diagnostic Context）动态绑定用户流水号是可行的，但需特别注意 MDC 的线程绑定特性和 synchronized 的锁粒度问题。MDC 本质依赖 ThreadLocal，它只对当前线程可见；而 synchronized 控制的是临界区的并发访问，并不改变线程上下文。因此，只要确保 MDC 的 put/remove 操作发生在**同一线程内**（即调用方线程），即使在 synchronized 块中操作也是安全且有效的。
为什么可以在 synchronized 内部操作 MDC
MDC 是基于 ThreadLocal<map></map> 实现的，其生命周期与线程强绑定。synchronized 只是让多个线程串行执行某段代码，并不会切换线程或清除当前线程的 ThreadLocal 数据。所以：
- synchronized 块中调用
MDC.put("traceId", "xxx")，仅影响当前线程的 MDC 映射 - 其他线程不受影响，也不会读到该 traceId
- 只要该线程后续日志由同一 logger 输出，logback/log4j 就能自动注入该 traceId
推荐写法：在业务入口处绑定 + try-finally 清理
不要在 synchronized 块“中间”随意 put，而应在进入同步逻辑前绑定、退出后及时清理，避免 MDC 泄漏（尤其在线程复用场景如 Tomcat 线程池中）：
public void processOrder(String orderId, String userId) {
// 生成唯一流水号，例如：userId + 时间戳 + 随机数
String traceId = userId + "-" + System.currentTimeMillis() + "-" + new Random().nextInt(1000);
<pre class="brush:php;toolbar:false;">// 绑定到当前线程 MDC
MDC.put("traceId", traceId);
try {
synchronized (orderLock) {
// 此处可安全使用 log.info("处理订单...")，traceId 自动生效
log.info("开始处理订单: {}", orderId);
doCriticalOperation(orderId);
}
} finally {
// 必须清理，防止线程复用导致 MDC 脏数据
MDC.clear();
}}
立即学习“Java免费学习笔记（深入）”；
注意事项与常见陷阱
- 不要在 synchronized 外部提前 clear：否则同步块内日志将丢失 traceId
-
避免跨线程传递 MDC：若同步块内启用了新线程（如 new Thread / CompletableFuture.runAsync），子线程默认无 MDC，需手动复制：
MDC.getCopyOfContextMap()+MDC.setContextMap(...) - Spring 环境建议用 HandlerInterceptor 或 Filter 统一注入：对 Web 请求，在 Controller 进入前绑定 traceId，比每个 service 方法手写更可靠
-
logback.xml 中需启用 %X{traceId} 格式，例如：
%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %X{traceId} - %msg%n
进阶：结合 AOP 自动管理 MDC
对高频使用的 service 方法，可用 @Around 切面统一注入 traceId，避免重复模板代码：
@Around("@annotation(org.springframework.web.bind.annotation.PostMapping) || " +
"@annotation(org.springframework.web.bind.annotation.PutMapping)")
public Object bindTraceId(ProceedingJoinPoint joinPoint) throws Throwable {
String traceId = generateTraceId(); // 实现自己的生成逻辑
MDC.put("traceId", traceId);
try {
return joinPoint.proceed();
} finally {
MDC.clear();
}
}这样所有被拦截的请求都会自动携带 traceId，包括其内部的 synchronized 逻辑，日志链路自然连贯。
