Spring Boot 2中自定义ObjectMapper返回ISO-8601格式日期

阿华AIGC实验室

2026-5-9

问题原因与解决方案

嗨，这个问题我之前也踩过坑！其实核心原因很明确：你自定义ObjectMapper时，没有启用Jackson对Java 8日期时间类型的支持模块，导致Jackson把LocalDateTime当成普通POJO来序列化，最终输出成了包含年、月、日等字段的数组。

为什么会这样？

Spring Boot默认会自动配置Jackson，其中已经内置了对Java 8日期类型（比如LocalDateTime、ZonedDateTime）的处理逻辑：它会自动注册JavaTimeModule模块，并且默认使用ISO-8601格式来序列化日期时间。

但当你手动创建并配置自定义的ObjectMapper时，相当于完全接管了Jackson的配置，Spring的默认自动配置会被覆盖——这时候如果没手动添加JavaTimeModule和对应的序列化规则，Jackson就会 fallback 到最原始的处理方式：把LocalDateTime的各个属性（年、月、日、时、分、秒、纳秒）拆成数组输出。

解决方法

根据你的自定义程度，有几种不同的实现方式：

1. 基于Spring默认配置做扩展（推荐）

如果你只是想在Spring默认Jackson配置的基础上添加自定义规则，不要完全新建ObjectMapper，而是通过Jackson2ObjectMapperBuilder来构建，这样会保留Spring默认的JavaTimeModule和ISO-8601格式化规则：

@Bean
public ObjectMapper objectMapper(Jackson2ObjectMapperBuilder builder) {
    ObjectMapper objectMapper = builder.build();
    // 在这里添加你的自定义配置，比如字段过滤、自定义序列化器等
    // 可选：显式关闭时间戳序列化，确保日期输出为文本格式
    objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
    return objectMapper;
}

2. 完全手动创建ObjectMapper

如果必须从零开始构建ObjectMapper，需要手动注册JavaTimeModule并配置日期序列化规则：

@Bean
public ObjectMapper objectMapper() {
    ObjectMapper objectMapper = new ObjectMapper();
    // 注册JavaTimeModule，专门处理Java 8日期时间类型
    objectMapper.registerModule(new JavaTimeModule());
    // 关闭将日期序列化为时间戳的特性，强制使用文本格式
    objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
    
    // （可选）如果需要更严格的ISO-8601格式（比如强制带Z时区），可以自定义序列化器
    DateTimeFormatter isoFormatter = DateTimeFormatter.ISO_INSTANT;
    objectMapper.registerModule(new JavaTimeModule()
            .addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(isoFormatter)));
    
    return objectMapper;
}

3. 配置文件方式（适合无代码自定义场景）

如果不需要编写代码级的Jackson自定义，直接在application.properties或application.yml中配置即可：

# application.properties
# 关闭日期转时间戳，启用文本格式
spring.jackson.serialization.write-dates-as-timestamps=false
# 指定ISO-8601日期格式化器
spring.jackson.date-format=com.fasterxml.jackson.databind.util.ISO8601DateFormat