SLF4J结合Log4j2实现JSON日志无转义输出的问题排查

问题根源 #

Log4j2的MessageResolver仅会对MultiformatMessage（如ObjectMessage、StructuredDataMessage）这类结构化消息做原生JSON解析，而普通字符串消息（对应MutableLogEvent中的SimpleMessage）会默认转义引号。你看到的MutableLogEvent是日志事件的容器，真正决定解析逻辑的是其中getMessage()返回的消息类型。

具体解决方案 #

1. 强制使用结构化消息类型

不要让开发者直接传入JSON字符串，而是封装工具方法，自动将日志内容转换为ObjectMessage：

// Lambda Powertools中可封装的示例工具方法
public class JsonLogger {
    private final Logger logger;

    public JsonLogger(Class<?> clazz) {
        this.logger = LoggerFactory.getLogger(clazz);
    }

    public void info(Object jsonPayload) {
        logger.info(new ObjectMessage(jsonPayload));
    }

    public void error(Throwable t, Object jsonPayload) {
        logger.error(t, new ObjectMessage(jsonPayload));
    }
}

开发者只需调用jsonLogger.info(Map.of("key", "value"))或直接传入POJO，就能生成原生JSON字段，无需手动拼接字符串。

2. 调整JsonTemplateLayout配置

确保模板正确使用message解析器，而非默认字符串处理。自定义模板示例（JsonTemplateLayout.json）：

{
  "timestamp": {
    "$resolver": "timestamp",
    "pattern": {
      "format": "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
      "timeZone": "UTC"
    }
  },
  "level": {"$resolver": "level"},
  "message": {"$resolver": "message"},
  "lambda_context": {"$resolver": "mdc"}
}

Log4j2配置中引用该模板：

<Appenders>
    <Console name="Console" target="SYSTEM_OUT">
        <JsonTemplateLayout eventTemplateUri="classpath:JsonTemplateLayout.json"/>
    </Console>
</Appenders>

3. 自动转换JSON字符串为结构化消息

如果开发者习惯传入JSON字符串，可自定义MessageFactory自动解析：

public class JsonMessageFactory extends DefaultMessageFactory {
    private static final ObjectMapper MAPPER = new ObjectMapper();

    @Override
    public Message newMessage(String message) {
        if (isJsonString(message)) {
            try {
                Object payload = MAPPER.readValue(message, Object.class);
                return new ObjectMessage(payload);
            } catch (JsonProcessingException e) {
                // 解析失败时 fallback到普通消息
                return super.newMessage(message);
            }
        }
        return super.newMessage(message);
    }

    private boolean isJsonString(String message) {
        return message != null && 
               ((message.startsWith("{") && message.endsWith("}")) 
                || (message.startsWith("[") && message.endsWith("]")));
    }
}

在Log4j2配置中指定该工厂：

<Configuration status="WARN" messageFactory="com.your.package.JsonMessageFactory">
    <!-- 其他配置 -->
</Configuration>

4. Lambda Powertools场景适配

• 提供注解式API，比如@LogJson，自动将方法参数/返回值作为结构化日志输出
• 整合Lambda上下文数据时，直接将request ID、函数ARN等作为结构化字段添加到MDC，而非拼接进消息字符串
• 封装SLF4J Logger的扩展类，隐藏ObjectMessage的创建细节，让开发者调用更简洁

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