Spring Boot中Logback的MDC无法输出用户名问题求助

我来帮你排查下这个MDC不生效的问题，结合Spring Security和Logback的特性，常见的原因和解决方法如下：

这是最容易忽略的基础问题：你必须在Logback的配置文件（logback.xml或logback-spring.xml）里，明确指定要打印的MDC键。比如你存入的MDC键是userId，那日志格式里要加上%X{userId}占位符：

<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg %X{userId}%n</pattern>
    </encoder>
</appender>

如果配置里没加这个占位符，哪怕MDC里有值也不会被打印出来。

你的JWTAuthorizationFilter继承了BasicAuthenticationFilter，它在Spring Security过滤器链中的执行时机是在认证过滤器之后。要确保你是在成功解析JWT并获取到有效用户信息后，再往MDC里存值，而且要放在过滤器链执行之前：

@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws IOException, ServletException {
    String token = extractTokenFromRequest(request);
    if (token != null && validateToken(token)) {
        String userId = getUserIdFromToken(token);
        // 存入MDC，一定要在chain.doFilter之前
        MDC.put("userId", userId);
    }

    try {
        // 继续执行后续过滤器链
        chain.doFilter(request, response);
    } finally {
        // 务必在finally块移除MDC值，避免线程复用导致的上下文污染
        MDC.remove("userId");
    }
}

这里的核心是：MDC是和当前线程绑定的，只有在后续代码（Controller、Service等）和当前线程同属一个上下文时，才能拿到MDC的值；而finally块的清理操作是必须的，因为Tomcat等容器会复用线程，不清理的话下一个请求可能会拿到上一个请求的残留MDC值。

如果你的项目用到了异步处理（比如@Async注解、异步Servlet、Spring MVC异步请求），MDC上下文会随着线程切换而丢失，因为它是线程绑定的。这种情况需要手动传递MDC：
比如针对@Async方法，你可以自定义一个带MDC传递的任务执行器：

@Bean
public TaskExecutor asyncTaskExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(5);
    executor.setMaxPoolSize(10);
    executor.setQueueCapacity(20);
    executor.setThreadNamePrefix("Async-");
    
    // 包装线程，传递MDC上下文
    executor.setTaskDecorator(runnable -> {
        Map<String, String> mdcContext = MDC.getCopyOfContextMap();
        return () -> {
            try {
                if (mdcContext != null) {
                    MDC.setContextMap(mdcContext);
                }
                runnable.run();
            } finally {
                MDC.clear();
            }
        };
    });
    executor.initialize();
    return executor;
}

你可以在存入MDC后立刻打一条日志，验证当前过滤器内是否能拿到值：

MDC.put("userId", userId);
LOGGER.info("当前过滤器内MDC userId: {}", MDC.get("userId"));

如果这条日志能正常打印出userId，但后续业务日志没有，那大概率是线程切换或过滤器顺序问题；如果这条日志也没打印，那就是你的token解析、userId获取逻辑有问题，导致MDC根本没存入有效值。

内容的提问来源于stack exchange，提问作者Naanavanalla