Spring Boot中Jackson序列化Instant日期格式不符的问题排查

问题根源 #

你尝试的几种方法大多针对java.util.Date类型，但Instant属于Java 8新时间API，由Jackson的JavaTimeModule单独处理，常规配置对其不生效；另外默认的InstantSerializer会在毫秒部分为0时自动省略，导致输出格式缺少.SSS。

有效解决方案 #

方案1：针对单个字段配置（@JsonFormat注解） #

修改SlotResponse实体，给Instant字段添加@JsonFormat时必须指定shape属性，否则注解对Instant不生效：

@Data
public class SlotResponse {
    @JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", shape = JsonFormat.Shape.STRING)
    private Instant start;
    @JsonFormat(pattern = "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", shape = JsonFormat.Shape.STRING)
    private Instant end;
}

方案2：全局配置（所有Instant统一格式） #

方式A：自定义ObjectBean配置

替换JavaTimeModule中默认的InstantSerializer，强制输出毫秒部分：

@Bean
public ObjectMapper objectMapper() {
    ObjectMapper mapper = new ObjectMapper();
    JavaTimeModule javaTimeModule = new JavaTimeModule();
    // 自定义序列化器，固定格式输出毫秒
    javaTimeModule.addSerializer(Instant.class, new InstantSerializer(
            InstantSerializer.INSTANCE,
            false,
            DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'")
    ));
    mapper.registerModule(javaTimeModule);
    mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
    return mapper;
}

方式B：Spring Boot配置属性（更简洁）

在application.properties或application.yml中添加：

# 配置Java 8时间类型的全局序列化格式
spring.jackson.format.date-time=yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
# 禁用日期转为时间戳的序列化方式
spring.jackson.serialization.write-dates-as-timestamps=false

原方法无效原因说明 #

1. 未指定shape的@JsonFormat：默认情况下该注解对Java 8时间类型不生效，必须配合shape=JsonFormat.Shape.STRING才能触发pattern解析。
2. spring.jackson.date-format：仅作用于java.util.Date，对Instant等Java 8新时间API无影响。
3. setDateFormat配置：同样只针对java.util.Date，Instant的序列化由JavaTimeModule的专属序列化器处理，不受此设置控制。
4. WRITE_DATES_WITH_ZONE_ID等特性：这些配置针对带时区的时间类型（如ZonedDateTime），Instant本身就是UTC时区，因此无效。

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