Java中实现全局JSON日期反序列化需配置ObjectMapper：注册JavaTimeModule，禁用WRITE_DATES_AS_TIMESTAMPS，为LocalDateTime、Instant等设置统一格式及时区（如Asia/Shanghai），并区分处理带/不带时区字符串。
Java 中实现全局统一的 JSON 日期反序列化，核心在于让 Jackson（主流 JSON 库）对所有日期时间类型（如 LocalDateTime、ZonedDateTime、Instant 等）使用一致的格式和时区规则，避免每个字段手动加 @JsonFormat 注解。
配置 ObjectMapper 全局日期格式
在 Spring Boot 项目中，最常用且推荐的方式是通过自定义 ObjectMapper Bean，注册统一的日期时间模块并设置默认格式与时区：
- 添加
JavaTimeModule（Jackson 2.12+ 已内置，无需额外依赖；老版本需引入jackson-datatype-jsr310） - 禁用默认的 timestamp 行为（
WRITE_DATES_AS_TIMESTAMPS = false），强制走字符串格式 - 为每种类型设置统一的序列化/反序列化格式（例如全部用
"yyyy-MM-dd HH:mm:ss"） - 指定反序列化时的默认时区（如
ZoneId.of("Asia/Shanghai")），解决LocalDateTime无时区但输入带时区字符串的问题
示例配置（Spring Boot）：
@Bean
public ObjectMapper objectMapper() {
ObjectMapper mapper = new ObjectMapper();
JavaTimeModule module = new JavaTimeModule();
// 统一 LocalDateTime 格式（不带时区）
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
module.addDeserializer(LocalDateTime.class,
new LocalDateTimeDeserializer(dtf));
module.addSerializer(LocalDateTime.class,
new LocalDateTimeSerializer(dtf));
// Instant 默认转为东八区字符串（或按需设为 UTC）
module.addDeserializer(Instant.class,
new InstantDeserializer(Instant::from, dtf, ZoneId.of("Asia/Shanghai")));
mapper.registerModule(module);
mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
return mapper;
}
处理跨时区与字符串歧义问题
JSON 中日期字符串可能含时区（如 "2024-05-20T10:30:00+08:00"）或不含（如 "2024-05-20 10:30:00"）。Jackson 默认对 LocalDateTime 不解析时区，直接报错。解决方案：
立即学习“Java免费学习笔记（深入）”；
- 对
LocalDateTime：只接受无时区字符串，用LocalDateTimeDeserializer+ 固定格式 - 对
ZonedDateTime或OffsetDateTime：允许带时区，用对应 deserializer 并指定默认时区兜底（如字符串无偏移量时补上ZoneId.systemDefault()） - 对
Instant：建议统一按 UTC 解析，或显式转换为指定时区再存为LocalDateTime
非 Spring 环境或 Jackson 原生使用
若未用 Spring，可手动构建全局生效的 ObjectMapper 实例，并确保所有 JSON 操作都复用它（避免 new 多个实例）：
- 创建单例
ObjectMapper，完成上述模块与格式配置 - 在工具类中封装
readValue()和writeValueAsString()方法，强制使用该实例 - 若用 Retrofit、Feign 等客户端，需将该
ObjectMapper注入其 JSON converter
注意兼容性与调试技巧
实际开发中容易踩坑的地方：
- 确认 Jackson 版本是否支持目标 Java 时间类型（如
java.time.Year需 Jackson 2.15+） - 检查是否有其他配置（如
@JsonFormat注解、全局SimpleModule）覆盖了你的设置 - 开启 Jackson 日志（
logging.level.com.fasterxml.jackson=DEBUG）观察实际使用的 deserializer - 单元测试务必覆盖空值、格式错误、时区边界值（如夏令时切换日）等场景
