Quarkus 3.8.1环境下MDC上下文线程间不共享问题求助

核心原因 #

Quarkus开发模式（quarkus dev）与生产模式（Docker/K8s环境）的线程调度、上下文传播逻辑存在本质差异：

• 开发模式为调试便利，线程上下文的MDC会自动在事件循环线程与工作线程间同步；
• 生产模式下Vert.x采用原生事件循环+工作线程池模型，SLF4J MDC的线程绑定特性默认不会跨线程自动传播，且quarkus-logging-logback扩展需要额外配置才能实现MDC的跨线程传递。

针对性解决方案 #

1. 开启Quarkus MDC上下文传播配置 #

确保已引入quarkus-smallrye-context-propagation依赖，并在application.properties中添加以下配置：

# 开启SLF4J MDC的上下文传播
quarkus.context-propagation.mdc=true
# 配置Logback扩展支持MDC跨线程传递
quarkus.logback.mdc-propagation=true

Quarkus 3.x版本中，默认的上下文传播未自动覆盖SLF4J MDC，需显式开启上述配置才能让MDC在Vert.x事件循环线程与工作线程间同步。

2. 替换为Vert.x Context存储请求ID（推荐） #

由于SLF4J MDC本身的线程绑定限制，改用Vert.x的全局上下文存储请求ID，再通过Logback自定义转换器读取：

• 在preMatchingFilter中存储请求ID：

@ServerRequestFilter(preMatching = true)
public void preMatchingFilter(ContainerRequestContext requestContext) {
    String requestId = <SOME-RANDOM-ID>;
    // 将请求ID存入Vert.x上下文
    Vertx.currentContext().put("X-Request-Id", requestId);
    // 同时写入SLF4J MDC供当前线程使用
    MDC.put("X-Request-Id", requestId);
}

• 自定义Logback转换器：

public class VertxRequestIdConverter extends ClassicConverter {
    @Override
    public String convert(ILoggingEvent event) {
        // 从Vert.x上下文读取请求ID
        Context vertxContext = Vertx.currentContext();
        if (vertxContext != null) {
            return vertxContext.get("X-Request-Id");
        }
        // 降级到当前线程MDC
        return MDC.get("X-Request-Id");
    }
}

• 在logback.xml中注册并使用该转换器：

<configuration>
    <conversionRule conversionWord="requestId" converterClass="com.yourpackage.VertxRequestIdConverter"/>
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg %requestId%n</pattern>
        </encoder>
    </appender>
    <!-- 其他日志配置 -->
</configuration>

3. 检查线程池上下文传播配置 #

确认application.properties中工作线程池的上下文传播已启用：

quarkus.thread-pool.context-propagation=true

该配置确保工作线程池在执行任务时会复制事件循环线程的上下文数据。

对已尝试方案的补充说明 #

• 添加quarkus-smallrye-context-propagation依赖但无效：未显式开启quarkus.context-propagation.mdc=true配置，导致MDC未纳入上下文传播范围；
• 自定义ThreadContextProvider无效：Quarkus 3.x对上下文传播的API做了调整，旧版实现不再适配；
• 改用org.jboss.logging.MDC：Logback依赖SLF4J的MDC实现，二者不共享上下文数据，因此无法传递到Logback日志中。

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