Spring Boot微服务RabbitMQ传POJO时java.time.Instant序列化/反序列化失败如何解决

解决方案 #

不需要将Instant替换为LocalDateTime，当前问题根源是Jackson没有正确加载JSR310规范的Java 8时间类型处理模块，无法完成Instant类型的序列化/反序列化匹配，按以下步骤修复即可：

步骤1：确认依赖引入

Spring Boot项目直接引入JSON Starter即可内置JSR310时间处理模块：

<!-- Maven依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-json</artifactId>
</dependency>

非Spring Boot手动管理依赖的项目，补充JSR310模块依赖：

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <version>匹配你使用的jackson版本即可</version>
</dependency>

步骤2：双侧配置统一的消息转换器

重点：生产者和消费者两个微服务都要配置相同的Jackson2JsonMessageConverter，仅单侧配置会出现序列化/反序列化规则不匹配的问题。
相比findAndRegisterModules()，显式注册JavaTimeModule兼容性更强，配置参考：

@Bean
public Jackson2JsonMessageConverter converter() {
    ObjectMapper objectMapper = new ObjectMapper()
            .registerModule(new JavaTimeModule())
            .disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
    return new Jackson2JsonMessageConverter(objectMapper);
}

可选的轻量化方案

如果不想全局修改配置，可以直接在POJO的Instant字段上标注序列化/反序列化器：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.datatype.jsr310.deser.InstantDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.InstantSerializer;
import java.time.Instant;

// 你的POJO类
public class TableTypeDto {
    @JsonSerialize(using = InstantSerializer.class)
    @JsonDeserialize(using = InstantDeserializer.class)
    private Instant createdDate;

    @JsonSerialize(using = InstantSerializer.class)
    @JsonDeserialize(using = InstantDeserializer.class)
    private Instant updatedDate;
    
    // 其余字段、get/set方法省略
}

额外注意

修复配置后需要清空RabbitMQ队列中旧的、错误格式的历史消息，否则消费历史消息仍然会报错。

不建议替换为LocalDateTime的原因：Instant本身是不带时区歧义的UTC时间戳，非常适合跨服务事件交互的场景，LocalDateTime不带时区信息，跨时区部署服务时极易出现时间偏移问题，没有替换的必要。

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