Spring Boot 3.4内置结构化日志如何实现Java对象的JSON结构化输出？

嘿，我刚好最近折腾过Spring Boot 3.4的这个新结构化日志特性，遇到过和你一模一样的问题，给你几个实用的解决办法！

你说的这个差异确实存在——Spring Boot默认的结构化日志为了性能考量，对复杂Java对象会直接调用toString()，而logstash的编码器会自动做JSON序列化。要实现对象的JSON结构化输出，有几个简单的路子：

• 最直接的快捷方式：用Json.wrap()包装对象
  Spring Boot 3.4的结构化日志API里特意提供了Json工具类，专门用来标记需要序列化为JSON的对象。你只需要把要日志的对象用Json.wrap()包一层就行，代码改成这样：

  log.atError()
      .addKeyValue("entry", Json.wrap(Map.entry("key", "value")))
      .log("message");
  

  这样输出的entry字段就会是标准的{"key":"value"}JSON结构，再也不是key=value的字符串了。这个方法零配置，适合零散的日志场景。

• 全局统一处理：自定义结构化日志转换器
  如果你的项目里有大量对象需要统一做JSON序列化，不想每次都写Json.wrap()，可以自定义一个全局转换器。创建一个实现StructuredLogConverter的类，注册成Spring Bean就行：

  @Component
  public class GlobalObjectJsonConverter implements StructuredLogConverter {
      private final ObjectMapper objectMapper = new ObjectMapper();
  
      @Override
      public Object convert(Object value) {
          // 这里可以按需判断对象类型，比如处理自定义DTO、Map.Entry等
          if (value instanceof Map.Entry<?, ?> entry) {
              try {
                  return objectMapper.writeValueAsString(entry);
              } catch (JsonProcessingException e) {
                  // 序列化失败时降级到toString()，避免日志报错
                  return value.toString();
              }
          }
          // 其他类型保持默认处理逻辑
          return value;
      }
  }
  

  这个转换器会全局生效，所有通过结构化日志API输出的匹配类型对象都会自动转成JSON，适合需要统一规范的项目。

• 深度定制：调整日志系统配置（以Logback为例）
  如果你用的是Logback作为日志实现，Spring Boot的内置结构化日志是和Logback的JsonProvider配合工作的。你可以在logback-spring.xml里配置自定义的JsonProvider，指定用Jackson来处理对象序列化。不过这个方式相对复杂一点，适合需要深度定制日志格式的场景，一般前两个方法足够覆盖大部分需求了。

总的来说，Json.wrap()是最省心的解决办法，完全不用额外配置，直接在代码里调整就行。Spring Boot这个设计其实是平衡了性能和灵活性——默认用toString()减少不必要的序列化开销，同时提供了快捷方式满足结构化输出的需求。

内容来源于stack exchange