Spring Boot跨版本跨时区@RequestBody日期字符串转换异常求助

问题根源 #

虽然POJO中checkinDateString声明为String类型，但Spring Boot默认依赖的Jackson JSON解析器会自动识别格式符合ISO 8601的字符串为日期类型。反序列化时，它会先把该字符串解析成日期对象，再转换为服务端时区（MST）的时间，最后转回字符串，最终导致时间被调整2小时（对应EST与MST的时差）。而直接用@RequestBody接收String类型时，Jackson不会触发自动类型推断，因此能保留原始字符串内容。

解决方法 #

1. 针对单个POJO字段禁用日期自动解析

在POJO的checkinDateString字段上添加注解，强制Jackson将其按纯字符串处理：

public class BookingRatesRQ {
    // 强制使用字符串反序列化器，避免Jackson误识别为日期
    @JsonDeserialize(using = StringDeserializer.class)
    private String checkinDateString;

    // getter、setter方法...
}

也可以用@JsonFormat指定字段形状为字符串：

@JsonFormat(shape = JsonFormat.Shape.STRING)
private String checkinDateString;

2. 全局配置Jackson，关闭日期自动检测

在服务端（Spring Boot 2.3.4）添加配置类，全局关闭Jackson自动识别日期类型的功能：

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper mapper = new ObjectMapper();
        // 关闭自动检测日期格式的字符串，避免触发时区转换
        mapper.disable(MapperFeature.AUTO_DETECT_DATES);
        // 关闭"将日期调整为上下文时区"特性，彻底规避时区转换逻辑
        mapper.disable(DeserializationFeature.ADJUST_DATES_TO_CONTEXT_TIME_ZONE);
        return mapper;
    }
}

3. 给请求中的日期字符串添加时区标识

如果业务允许，让消费者发送的日期字符串带上时区信息，比如"2022-12-12T07:00:00-05:00"（EST时区）。这样服务端Jackson解析时会基于指定时区处理，不会自动转换为服务端时区。

4. 统一客户端与服务端时区（临时规避）

将消费者时区改为MST能解决问题，但这只是临时方案。如果业务需要保持不同时区，建议优先采用前三种方法。

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