在处理历史数据（尤其是 1986 年至 1991 年间出生的用户信息）时，开发者常会遇到一个诡异的问题：数据库中存储的日期明明是正确的，但通过接口返回给前端时，日期却无故"少了一天"。通过排查发现，这类问题往往指向了 @JsonFormat 注解在处理夏令时（Daylight Saving Time, DST）时的特殊表现。

问题背景：消失的 24 小时

在 Java Web 开发中，我们习惯使用 Jackson 提供的 @JsonFormat 注解来格式化 Date 类型的字段。例如：

public class UserProfile {
    @JsonFormat(pattern = "yyyy-MM-dd")
    private Date birthday;
    // getters and setters
}

当数据库中存储的日期为 1988-05-01 时，接口返回的 JSON 可能是 1988-04-30。这种现象集中出现在特定年份，原因在于中国在 1986 年至 1991 年期间实行过夏令时政策。在夏令时期间，时钟会被人为拨快一小时。如果 Jackson 在序列化时没有正确处理时区，或者默认使用了 UTC 时区，由于时差偏移，原本 00:00:00 的时间点在转换后会变成前一天的 23:00:00，截取日期后便导致了日期偏差。

夏令时的历史影响

根据历史记录，中国在 1986 年至 1991 年实行夏令时，每年 4 月中旬的某个周日凌晨开始，至 9 月中旬的某个周日凌晨结束。在这一时间段内，北京时间（GMT+8）实际上变成了 GMT+9。如果程序在转换时间时，时区环境配置不当，就会触发上述的日期回退 bug。

解决方案

1. 显式指定时区为 GMT+8

最直接的办法是在 @JsonFormat 注解中明确指定时区。通过将时区设置为 GMT+8，可以强制 Jackson 使用东八区进行计算，避免默认 UTC 时区带来的偏移。

public class UserInfo {
    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
    private Date dateOfBirth;
}

2. 使用 Asia/Shanghai 逻辑时区

相比于静态的 GMT+8，使用 Asia/Shanghai 更加严谨。它包含了中国历史上的夏令时变更逻辑，能够更准确地处理历史遗留时间点。配合 locale 参数可以确保本地化处理的一致性。

public class UserEntity {
    @JsonFormat(
        pattern = "yyyy-MM-dd", 
        timezone = "Asia/Shanghai", 
        locale = "zh_CN"
    )
    private Date birthDate;
}

3. 全局 JVM 参数配置

如果项目中涉及大量的日期处理，逐个修改注解可能效率较低。可以通过在应用启动时设置 JVM 参数，统一全局默认时区：

-Duser.timezone=GMT+08

或者在 Spring Boot 启动类中通过代码设置：

@PostConstruct
public void init() {
    TimeZone.setDefault(TimeZone.getTimeZone("GMT+8"));
}

4. 升级日期处理 API

从长远来看，建议将传统的 java.util.Date 替换为 Java 8 引入的 java.time.LocalDate。LocalDate 只包含日期信息，不包含时间信息和时区偏移，从根源上规避了夏令时导致的序列化问题。

public class ModernUser {
    // LocalDate 不受时区和夏令时偏移影响
    @JsonFormat(pattern = "yyyy-MM-dd")
    private LocalDate birthday;
}