配置Jackson将ZonedDateTime序列化为指定格式未生效，如何处理？

一、自定义ObjectMapper未生效的原因及修复 #

1. Spring Boot默认ObjectMapper优先级冲突 #

Spring Boot自动配置会生成一个默认的ObjectMapper实例，若你自定义的Bean未标记@Primary，容器会优先使用默认实例，导致你的序列化配置不生效。

修复方法：给自定义ObjectMapper Bean添加@Primary注解，确保Spring优先注入你的配置：

@Bean
@Primary
public ObjectMapper objectMapper() {
    ObjectMapper objectMapper = new ObjectMapper();
    JavaTimeModule javaTimeModule = new JavaTimeModule();
    javaTimeModule.addSerializer(ZonedDateTime.class, new ZonedDateTimeSerializer(DateTimeFormatter.ISO_INSTANT));
    objectMapper.registerModule(javaTimeModule);
    objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
    return objectMapper;
}

2. 未绑定到REST请求的消息转换器 #

使用@RestController时，Spring依赖MappingJackson2HttpMessageConverter处理JSON序列化，若未将自定义ObjectMapper关联到该转换器，配置同样不会生效。需手动配置消息转换器：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Autowired
    private ObjectMapper customObjectMapper;

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        converter.setObjectMapper(customObjectMapper);
        converters.add(0, converter); // 置于首位确保优先使用
    }
}

3. 代码中手动创建ObjectMapper实例 #

若业务代码存在new ObjectMapper()的写法，会绕过Spring容器中配置的自定义实例，导致序列化规则不生效。需确保所有序列化操作均使用注入的ObjectMapper。

二、截断ZonedDateTime后请求成功的原因 #

你所说的"截断ZonedDateTime"，本质是将时间的小数秒精度限制为三位，刚好匹配了合作方系统的格式要求：

• 合作方的解析器可能仅严格支持三位小数秒的yyyy-MM-dd'T'HH:mm:ss.SSSZ格式，而你的原始ZonedDateTime带有更多小数位（如示例中的00688是五位），触发了解析失败。
• 截断后，时间字符串的小数秒部分缩短为三位，符合合作方的格式校验规则，因此请求被成功接受。

你也可以直接在序列化时强制限制小数秒位数，无需手动截断：
修改序列化器的格式化器，指定固定三位小数秒：

javaTimeModule.addSerializer(ZonedDateTime.class, 
    new ZonedDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSX")));

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