Spring Boot中如何全局添加自定义Serializer格式化所有Instant值？

你之前尝试用configOverride配置Instant的格式化未达到预期，原因是Jackson默认的Instant序列化器不会响应这种方式的格式配置，需要显式指定序列化器并配置格式化规则，同时要注意Instant是UTC时间，格式化时需指定时区避免时间偏差。

以下是两种可行的全局配置方案：

方案一：沿用Jackson2ObjectMapperBuilderCustomizer（推荐，与你现有LocalDateTime配置风格统一） #

@Configuration
public class AppConfig {
   
    private static final String DATE_TIME_FORMAT = "dd.MM.yyyy HH:mm:ss";
    // 根据业务需求指定时区，此处以UTC为例
    private static final ZoneId TARGET_ZONE = ZoneId.of("UTC");

    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
        return builder -> {
            // 保留原有的LocalDateTime序列化配置
            builder.serializers(new LocalDateTimeSerializer(
                DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)));
            
            // 配置Instant的序列化器
            DateTimeFormatter instantFormatter = DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)
                    .withZone(TARGET_ZONE);
            builder.serializers(new InstantSerializer(InstantSerializer.INSTANCE, instantFormatter));
        };
    }
}

方案二：直接配置ObjectMapper #

如果需要自定义更多ObjectMapper细节，可采用这种方式，核心是注册JavaTimeModule并替换Instant的序列化器：

@Configuration
public class AppConfig {
    private static final String DATE_TIME_FORMAT = "dd.MM.yyyy HH:mm:ss";
    private static final ZoneId TARGET_ZONE = ZoneId.of("UTC");

    @Bean
    ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        JavaTimeModule timeModule = new JavaTimeModule();
        
        // 配置Instant序列化器
        DateTimeFormatter instantFormatter = DateTimeFormatter.ofPattern(DATE_TIME_FORMAT)
                .withZone(TARGET_ZONE);
        timeModule.addSerializer(Instant.class, new InstantSerializer(InstantSerializer.INSTANCE, instantFormatter));
        
        // 注册时间模块，保留其他JSR310类型的序列化支持
        mapper.registerModule(timeModule);
        return mapper;
    }
}

关键说明 #

• Instant是基于UTC的时间戳，格式化时必须指定时区（如UTC或业务所需时区），否则会使用默认时区导致时间显示错误。
• 不要直接用configOverride设置Instant格式，因为Jackson默认的Instant序列化器不支持这种配置方式，必须显式替换为支持格式化的序列化器。

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