Spring Boot 3升级至4后Jackson序列化丢失字段问题

问题分析 #

从Spring Boot 3迁移到4后，Jackson序列化MyData类时未输出包含元素的events列表，核心原因大概率是Jackson版本升级（Spring Boot 4配套Jackson 2.16+）带来的默认配置变化，或字段/方法的微小不兼容问题。

修复步骤 #

1. 排查字段泛型与Getter方法 #

• 修正泛型错误：你的MyData类中events字段定义为List<MyEvents>，但实际类名是MyEvent，存在泛型不匹配。Spring Boot 3的Jackson可能兼容了该笔误，而Spring Boot 4的Jackson更严格，导致无法识别字段。将其修正为：

  private List<MyEvent> events = new ArrayList<>();
  

• 确认Getter正确性：确保MyData类存在正确命名的Getter方法：

  public List<MyEvent> getEvents() {
      return events;
  }
  

  若Getter缺失或命名错误（比如写成getEvent()），Jackson无法识别该字段进行序列化。

2. 显式配置Jackson序列化规则 #

如果上述排查无问题，可通过自定义ObjectMapper强制Jackson序列化目标字段：
修改你的JacksonConfiguration类，添加ObjectMapper Bean配置：

@Configuration
@EnableSpringDataWebSupport(pageSerializationMode = EnableSpringDataWebSupport.PageSerializationMode.VIA_DTO)
public class JacksonConfiguration {
    private static final Logger LOGGER = LoggerFactory.getLogger(JacksonConfiguration.class);

    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 序列化所有非空字段（包含有元素的集合）
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
        // 允许Jackson直接访问私有字段（无需依赖Getter）
        mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
        return mapper;
    }

    @PostConstruct
    private void configurationInitialized() {
        LOGGER.info("Configuration JacksonConfiguration being initialized");
    }
}

3. 显式标记序列化字段 #

可在events字段上添加@JsonProperty注解，强制Jackson识别并序列化该字段：

public class MyData {
    // ...其他字段
    @JsonProperty("events")
    private List<MyEvent> events = new ArrayList<>();
    // ...getters and setters
}

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