Java Spring Data JPA按Date日期查询返回空及时区转换问题

本质就是时区不匹配：
你传入的Wed Jun 22 00:00:00 CDT 2022是美国中部夏令时（UTC-5）时间，对应的UTC标准时间正好是2022-06-22 05:00:00.000，你的JPA/数据库默认用UTC时区持久化java.util.Date，所以存进去的是UTC对应的时间戳。
但你查询时传入的Date参数是按应用服务器默认的CDT时区生成的，JPA拼SQL时没有做对应的时区转换，直接把CDT时间当成UTC时间去库里匹配，相当于实际查询的时间比库里存的值早了5个小时，自然查不到结果。之前存完再返回前端能正常显示，是因为Jackson序列化时会自动按应用默认时区把UTC时间转回CDT，整条链路没出问题而已。

按改动成本从低到高选：

• 配置全局JPA时区（最省事，改动最小）
  直接在项目配置里强制Hibernate用UTC时区处理所有时间字段的读写，存和查的逻辑统一就不会有偏移：
  如果是SpringBoot项目，直接加配置：

  # 强制Hibernate用UTC处理JDBC时间
  spring.jpa.properties.hibernate.jdbc.time_zone=UTC
  # 数据库连接串也强制指定UTC时区，以MySQL为例
  spring.datasource.url=jdbc:mysql://你的数据库地址:端口/库名?serverTimezone=UTC
  

  加完不用改任何业务代码，查询时传入的Date会自动转成UTC对应的时间戳和库里匹配。
• 手动转换查询参数（怕改全局配置影响其他业务的话选这个）
  直接在调用查询方法前，把传入的CDT时间手动转成和库里一致的UTC时间，代码直接用：

  // 前端传入的、按CDT解析的Date对象
  Date originDate = 前端传进来的日期参数;
  SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
  // 先按CDT时区格式化原始时间
  formatter.setTimeZone(TimeZone.getTimeZone("America/Chicago"));
  String cdtTime = formatter.format(originDate);
  // 再按UTC解析成查询用的Date对象，值就和库里存的完全一致
  formatter.setTimeZone(TimeZone.getTimeZone("UTC"));
  Date queryParam = formatter.parse(cdtTime);
  // 传入queryParam调用findByDate即可查到匹配数据
  

• 改范围查询（容错率最高，推荐长期用）
  本身查指定日期的订单就没必要做精确到毫秒的等值匹配，直接按日期区间查，还能规避数据库时间精度、时区配置变动带来的问题，修改Repository方法：

  @Query("SELECT o FROM Order o JOIN o.boats b WHERE b.date >= ?1 AND b.date < ?2")
  Set<Order> findByDateRange(Date dayStart, Date nextDayStart);
  

  调用前把传入的日期处理成CDT时区当天0点对应的UTC时间、以及次日0点对应的UTC时间作为参数传入即可，不会再出现匹配不到的问题。

注意：如果后续有排期做时间类型迁移，直接把所有java.util.Date换成LocalDateTime/ZonedDateTime，配合时区注解指定对应时区，能从根源上避免这类时区坑。

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