Java Spring Boot中java.sql.Date解析后值变更问题求助

1. 统一应用全局时区为UTC #

在application.properties或application.yml中添加配置，强制Spring和Jackson使用UTC时区：

# 配置Jackson序列化/反序列化时区
spring.jackson.time-zone=UTC
# 配置JVM默认时区（也可通过启动参数-Duser.timezone=UTC设置）
user.timezone=UTC

也可在启动类中显式设置时区确保生效：

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        TimeZone.setDefault(TimeZone.getTimeZone("UTC"));
        SpringApplication.run(YourApplication.class, args);
    }
}

此方案让应用全程以UTC处理日期，从根源避免客户端与服务器时区差异导致的日期偏移。

2. 配置Hibernate/JDBC的时区 #

让Hibernate在与JDBC交互时使用UTC处理java.sql.Date，避免Hibernate自动转换为本地时区：

spring.jpa.properties.hibernate.jdbc.time_zone=UTC

PostgreSQL的date类型本身不带时区信息，Hibernate如果使用本地时区解析java.sql.Date的毫秒值，会导致日期计算错误，该配置强制Hibernate用UTC来映射java.sql.Date与数据库date类型。

3. 统一测试环境时区 #

测试代码中时区不一致会直接导致断言失败，可在测试类中设置UTC时区：

@SpringBootTest
public class BookingTest {
    @BeforeAll
    static void setup() {
        TimeZone.setDefault(TimeZone.getTimeZone("UTC"));
    }

    // 测试用例逻辑...
}

也可通过测试属性源配置：

@TestPropertySource(properties = {"spring.jackson.time-zone=UTC", "user.timezone=UTC"})
@SpringBootTest
public class BookingTest {
    // 测试用例逻辑...
}

4. 数据库连接URL指定时区 #

在PostgreSQL的JDBC连接URL中添加时区参数，确保驱动与数据库交互时使用UTC：

spring.datasource.url=jdbc:postgresql://localhost:5432/your_db?serverTimezone=UTC

原理说明 #

java.sql.Date本质是存储自1970-01-01 00:00:00 UTC以来的毫秒数，不同时区解析该毫秒值会得到不同日期字符串。比如客户端在GMT时区将2023-11-06解析为UTC零点的毫秒值，服务器用GMT-5时区解析时，会得到2023-11-04（UTC零点对应GMT-5的前一天19点，日期被截断为前一天）。统一应用、Hibernate、JDBC、测试全环节的时区为UTC，即可消除这类转换差异。

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