JPQL查询参数中java.util.Date未转换为UTC的问题

你遇到的问题其实很典型：虽然java.util.Date本质上是与时区无关的UTC时间戳（底层就是一个long型的毫秒数），但JPA在将Date参数绑定到SQL查询时，默认会使用JVM当前的默认时区来格式化这个时间戳为字符串，再传递给数据库。这就导致你的本地时区参数和数据库里存储的UTC时间戳做比较时，出现了偏移，查询结果自然不对。

下面给你几个可行的解决方案，按推荐程度排序：

1. 升级到Java 8+的时间API（最优方案） #

java.util.Date是一个设计缺陷较多的类，Java 8引入的java.time包（JSR-310）提供了更清晰、线程安全的时间类型，比如Instant（代表UTC时间线上的一个点）。

步骤： #

• 修改你的EventEntity实体类，将startTime和endTime字段替换为Instant：

  @Entity
  public class EventEntity {
      // 其他字段...
      
      @Column(name = "start_time")
      private Instant startTime;
      
      @Column(name = "end_time")
      private Instant endTime;
      
      // getter和setter...
  }
  

• 调整查询方法的参数类型为Instant：

  public List<EventEntity> getEventsInPeriod(Instant start, Instant end) {
      return em.createQuery(
              "Select e from EventEntity e where e.startTime < :periodEnd and e.endTime > :periodStart", 
              EventEntity.class)
          .setParameter("periodStart", start)
          .setParameter("periodEnd", end)
          .getResultList();
  }
  

这样处理后，Instant会被JPA直接解析为UTC时间戳传递给数据库，完全避免了时区转换的问题，从根源上解决了你的困扰。

2. 全局配置JPA使用UTC时区（次优方案） #

如果暂时无法升级时间API，可以通过配置让JPA在处理所有日期类型时默认使用UTC时区。以Hibernate为例，你可以在persistence.xml或者Spring配置中添加：

hibernate.jdbc.time_zone=UTC

这个配置会让Hibernate在绑定Date参数、读取数据库日期时都使用UTC时区，不需要在每次查询中手动设置时区，全局生效且线程安全。

3. 临时切换JVM默认时区（应急方案） #

你之前尝试的TimeZone.setDefault(TimeZone.getTimeZone("UTC"))可以解决问题，但要注意线程安全问题——因为这个方法是全局的，会影响整个JVM内的所有线程。如果是多线程环境，必须在查询前后恢复原有时区：

public List<EventEntity> getEventsInPeriod(Date start, Date end) {
    // 保存原有时区
    TimeZone originalTimeZone = TimeZone.getDefault();
    try {
        // 临时设置为UTC
        TimeZone.setDefault(TimeZone.getTimeZone("UTC"));
        return em.createQuery(
                "Select e from EventEntity e where e.startTime < :periodEnd and e.endTime > :periodStart", 
                EventEntity.class)
            .setParameter("periodStart", start)
            .setParameter("periodEnd", end)
            .getResultList();
    } finally {
        // 必须恢复原有时区，避免影响其他线程
        TimeZone.setDefault(originalTimeZone);
    }
}

这个方法可以应急，但不推荐在生产环境的多线程场景下长期使用，容易引发难以排查的时区问题。

再解释一下你的疑惑： #

java.util.Date本身确实是时区无关的，但JDBC驱动在将Date转换为数据库能识别的格式时，会使用JVM默认时区来生成日期字符串（比如你日志里的2020-08-01 15:30:00.0），而数据库里存储的是UTC时间戳，两者时区不一致，导致比较逻辑出错。设置默认时区为UTC后，JDBC驱动生成的字符串就是UTC时间，和数据库存储的一致，所以查询结果正确。

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