Spring Boot+Hibernate中java.util.Date存MySQL提前一天问题解决

我之前也踩过这个一模一样的坑！结合你描述的场景——全局时区设为UTC、用java.util.Date+@Temporal映射DATE/TIME类型、JWT模块用Date正常工作，咱们一步步把这个日期偏移的问题解决掉：

1. 先把MySQL数据库的时区拉齐到UTC #

很多时候问题出在数据库本身的时区和应用不一致。先登录MySQL执行命令确认时区：

SELECT @@global.time_zone, @@session.time_zone;

如果返回的不是+00:00或者UTC，就修改MySQL的配置文件（my.cnf或my.ini）：

[mysqld]
default-time-zone = '+00:00'

改完重启MySQL服务，确保数据库层面用UTC时区。

2. 给JDBC连接URL加上时区参数 #

这是最容易被忽略的一步！哪怕你全局设了UTC，JDBC连接时如果不指定时区，Hibernate和MySQL的时区协商会出问题。在application.properties（或yml）里修改你的数据源URL：

spring.datasource.url=jdbc:mysql://localhost:3306/your_db_name?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC

注意一定要用serverTimezone=UTC，别用GMT——MySQL对GMT的处理和UTC有细微差异，容易踩坑。

3. 强制Hibernate使用UTC时区处理日期 #

虽然你配置了全局时区，但Hibernate有自己的时区配置项，必须明确指定，避免它默认使用JVM的时区：

# Spring Boot 2.x及以上版本用这个
spring.jpa.properties.hibernate.jdbc.time_zone=UTC
# 如果你用的是Spring Boot 1.x，换成下面这个
# spring.jpa.properties.hibernate.time_zone=UTC

这个配置会让Hibernate在读写java.util.Date时，强制用UTC时区和数据库交互，从根源上避免时区转换的偏移。

4. 实体类中@Temporal的正确使用姿势 #

你用@Temporal(TemporalType.DATE)和@Temporal(TemporalType.TIME)时要注意：DATE类型会截断Date的时间部分，但如果你的Date对象是用非UTC时区生成的，就会导致日期偏移。

比如，假设你的JVM是东8区，你生成一个Date代表“2024-05-20”，如果用默认时区解析，它对应的UTC时间其实是2024-05-19 16:00:00，存到UTC数据库里就会变成2024-05-19——这就是“提前一天”的原因！

所以赋值Date字段时，一定要确保是UTC时区的Date对象。比如解析前端传的日期字符串：

// 明确用UTC时区解析日期字符串
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
dateFormat.setTimeZone(TimeZone.getTimeZone("UTC"));
Date reservationDate = dateFormat.parse("2024-05-20");

5. 保持JWT模块的日期处理一致性 #

你提到JWT模块用java.util.Date正常工作，那要确保JWT里的日期生成也是基于UTC的。比如生成过期时间时：

// System.currentTimeMillis()本身就是UTC时间戳，生成的Date是UTC的，没问题
Date expirationDate = new Date(System.currentTimeMillis() + 3600000); // 1小时后

// 如果用Calendar，一定要指定UTC时区
Calendar cal = Calendar.getInstance(TimeZone.getTimeZone("UTC"));
cal.add(Calendar.HOUR_OF_DAY, 1);
Date expDate = cal.getTime();

整个应用的日期处理逻辑都统一用UTC，就不会出现局部偏移的问题。

6. 写个测试验证一下 #

最后写个简单的测试用例，确认问题解决：

@SpringBootTest
public class ReservationDateTest {
    @Autowired
    private ReservationRepository reservationRepo;

    @Test
    public void testSaveAndRetrieveDate() {
        Reservation reservation = new Reservation();
        
        // 构造一个明确的UTC日期：2024-05-20 00:00:00 UTC
        Calendar utcCalendar = Calendar.getInstance(TimeZone.getTimeZone("UTC"));
        utcCalendar.set(2024, Calendar.MAY, 20, 0, 0, 0);
        utcCalendar.set(Calendar.MILLISECOND, 0);
        
        reservation.setReservationDate(utcCalendar.getTime());
        reservation.setReservationTime(utcCalendar.getTime());
        
        reservationRepo.save(reservation);
        
        // 从数据库查询并验证
        Reservation savedRes = reservationRepo.findById(reservation.getId()).orElseThrow();
        SimpleDateFormat utcSdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        utcSdf.setTimeZone(TimeZone.getTimeZone("UTC"));
        
        System.out.println("保存的日期（UTC）：" + utcSdf.format(savedRes.getReservationDate()));
        // 正常情况下应该输出2024-05-20 00:00:00，不会提前一天
    }
}

核心原因就是Hibernate、JDBC、MySQL三者的时区没有完全统一为UTC，导致日期在转换过程中出现了偏移。把这几个环节的时区都明确设为UTC，再确保代码中处理Date时始终用UTC，就能彻底解决这个问题。

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