Jackson LocalDate/LocalDateTime反序列化配置异常问题咨询

我之前也踩过这个一模一样的坑！序列化时REST API返回的字符串格式好好的，但往服务器发数据反序列化直接炸，核心原因大多是你只搞定了序列化的配置，反序列化的逻辑没跟上，或者Jackson根本没拿到处理Java 8时间类型的能力。

下面给你一步步解决的方案：

1. 先确认依赖是否到位 #

Jackson处理Java 8的时间类型（java.time.*）需要专门的模块支持，先确保你的项目里引入了jackson-datatype-jsr310：

Maven依赖 #

<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <!-- 版本最好和你用的jackson-core/jackson-databind一致 -->
    <version>2.15.2</version>
</dependency>

Gradle依赖 #

implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.15.2'

2. 正确配置ObjectMapper #

序列化正常说明你可能已经开了WRITE_DATES_AS_TIMESTAMPS禁用，但一定要注册JavaTimeModule——这个模块同时负责序列化和反序列化的逻辑，没注册的话Jackson根本不知道怎么把字符串转成LocalDate/LocalDateTime。

ObjectMapper objectMapper = new ObjectMapper();
// 注册Java 8时间模块，这是关键！
objectMapper.registerModule(new JavaTimeModule());
// 全局禁用时间戳格式，强制用字符串表示
objectMapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);

3. 适配JAX-RS客户端的配置 #

你提到用的是javax.ws.rs的客户端，那得把上面配置好的ObjectMapper注册到客户端的Provider里，不然客户端会用默认的ObjectMapper，自然处理不了时间类型：

// 创建JAX-RS客户端
Client client = ClientBuilder.newClient();
// 把自定义的ObjectMapper绑定到JacksonJsonProvider
JacksonJsonProvider jsonProvider = new JacksonJsonProvider(objectMapper);
// 注册到客户端
client.register(jsonProvider);

4. 实体类上的注解优化（可选） #

如果某个字段需要自定义格式（比如和全局格式不一样），可以用@JsonFormat注解，一定要指定shape = JsonFormat.Shape.STRING，确保反序列化时按字符串解析：

import com.fasterxml.jackson.annotation.JsonFormat;
import java.time.LocalDate;
import java.time.LocalDateTime;

public class YourEntity {
    @JsonFormat(pattern = "yyyy-MM-dd", shape = JsonFormat.Shape.STRING)
    private LocalDate dateField;

    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", shape = JsonFormat.Shape.STRING)
    private LocalDateTime dateTimeField;

    // getter/setter省略
}

常见踩坑点排查 #

• 如果你用的是Spring Boot，不用手动注册模块，只要引入依赖，Spring会自动配置，但要确保application.properties里没开奇怪的时间配置
• 检查传入的字符串格式和你配置的pattern是否完全匹配，比如少了时分秒、用了斜杠代替横杠都会导致反序列化失败
• 老版本Jackson（2.6之前）用的是JSR310Module而不是JavaTimeModule，如果你的版本特别老，记得换模块类名

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