SpringBoot3+GraalVM原生模式下Logback MDC为空问题求助

在SpringBoot3应用中使用GraalVM原生镜像运行时，出现Logback JsonEncoder输出的MDC始终为空的异常情况：

• 常规JVM运行模式下，MDC能正常填充path、method、operator等请求相关字段
• 切换到GraalVM原生模式后，MDC字段为空，但Logback官方文档明确说明配置正确时MDC应自动填充

SpringBoot模式日志输出 #

Invalid Request. 
#error: Validation failed for argument [0] in public io.registry.dto.response.HubResponse ....
{"sequenceNumber":0,"timestamp":1707047416084,"nanoseconds":84264000,"level":"ERROR","threadName":"http-nio-50550-exec-2","loggerName":"io.registry.exception.PlatformRegistryExceptionHandler","context":{"name":"default","birthdate":1707047397944,"properties":{}},
"mdc": {"path":"/hubs","comment":"test attribute","method":"POST","operator":"jasmine","X-CORRELATION-ID":"d0037334-655e-4e96-88a7-aee4bf00ce3d"},
"message":"Invalid Request. \n#error: {}","arguments": ["Validation failed for argument [0] in public io.registry.dto.response.HubResponse io.registry.controller.HubController.registerHub(io.registry.model.request.HubRequest,java.lang.String,java.lang.String) throws io.registry.exception.PlatformRegistryException: [Field error in object 'hubRequest' on field 'name': rejected value []; codes [Size.hubRequest.name,Size.name,Size.java.lang.String,Size]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [hubRequest.name,name]; arguments []; default message [name],15,3]; default message [size must be between 3 and 15]] "],"throwable":null}     

原生模式日志输出 #

Invalid Request. 
#error: Validation failed for argument [0] in public io.registry.dto.response.HubResponse io.registry.controller.HubController.registerHub(io.registry.model.request.HubRequest,java.lang.String,java.lang.String) throws io.registry.exception.PlatformRegistryException: [Field error in object 'hubRequest' on field 'name': rejected value []; codes [Size.hubRequest.name,Size.name,Size.java.lang.String,Size]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [hubRequest.name,name]; arguments []; default message [name],15,3]; default message [size must be between 3 and 15]] 
{"sequenceNumber":0,"timestamp":1707047561881,"nanoseconds":881714000,"level":"ERROR","threadName":"http-nio-50550-exec-4","loggerName":"io.registry.exception.PlatformRegistryExceptionHandler","context":{"name":"default","birthdate":1707047555494,"properties":{}},
"mdc": {},
"message":"Invalid Request. \n#error: {}","arguments": ["Validation failed for argument [0] in public io.registry.dto.response.HubResponse io.registry.controller.HubController.registerHub(io.registry.model.request.HubRequest,java.lang.String,java.lang.String) throws io.registry.exception.PlatformRegistryException: [Field error in object 'hubRequest' on field 'name': rejected value []; codes [Size.hubRequest.name,Size.name,Size.java.lang.String,Size]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [hubRequest.name,name]; arguments []; default message [name],15,3]; default message [size must be between 3 and 15]] "],"throwable":null}

当前logback-spring.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <include resource="org.springframework.boot.logging.logback/defaults.xml"/>
    <include resource="org.springframework.boot.logging.logback/console-appender.xml" />

    <appender name="jsonEncoder" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.JsonEncoder"/>
    </appender>

    <root level="INFO">
        <appender-ref ref="jsonEncoder" />
    </root>
</configuration>

排查与解决步骤 #

1. 补全GraalVM反射元数据
   Spring Boot自动配置的MDC填充过滤器（如MdcFilter、ServletRequestLoggingFilter）在原生模式下需要反射支持。检查src/main/resources/META-INF/native-image/reflect-config.json，确保包含这些类的配置，若缺失则手动添加：

   [
     {
       "name": "org.springframework.web.filter.MdcFilter",
       "allDeclaredConstructors": true,
       "allPublicConstructors": true,
       "allDeclaredMethods": true,
       "allPublicMethods": true
     },
     {
       "name": "org.springframework.web.filter.ServletRequestLoggingFilter",
       "allDeclaredConstructors": true,
       "allPublicConstructors": true,
       "allDeclaredMethods": true,
       "allPublicMethods": true
     }
   ]
   

2. 显式启用MDC配置
   在application.properties中添加以下配置，强制开启Web请求的MDC自动填充：

   spring.mdc.enabled=true
   spring.web.mdc.enabled=true
   

3. 替换为Spring适配的JsonEncoder
   原生模式下Spring Boot提供的JsonEncoder兼容性更好，修改logback配置中的编码器类：

   <encoder class="org.springframework.boot.logging.logback.JsonEncoder"/>
   

4. 启用线程上下文支持
   在src/main/resources/META-INF/native-image/native-image.properties中添加配置，确保GraalVM支持ThreadLocal（MDC基于ThreadLocal实现）：

   -H:+EnableThreadLocalSupport
   

5. 重新生成AOT配置
   执行Spring AOT生成命令，确保原生镜像配置完整：

   # Maven
   mvn spring-boot:aot-generate
   # Gradle
   ./gradlew bootAotGenerate
   

   之后重新构建原生镜像。

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