Spring Data JPA中JPQL与原生查询返回结果不一致问题排查

我之前碰到过几乎一模一样的问题，核心原因大概率是日期参数的时间精度或时区不匹配导致的，咱们来仔细拆解：

可能的原因 #

• Java Date参数带有时分秒偏差：Java的Date类型实际包含时分秒信息，如果你的代码中生成的date参数不是精确的2018-05-22 00:00:00（比如因为时区转换变成了2018-05-22 08:00:00，这是东八区环境下的常见情况），那么数据库中TRANS_DATE为2018-05-22的记录（MySQL的DATE类型会被视为2018-05-22 00:00:00）会被>= :date的条件过滤掉。而你在数据库工具中直接传入字符串'2018-05-22'，MySQL会自动解析为当天0点，所以能查到所有数据。
• Hibernate对JPQL和原生查询的参数处理差异：JPQL查询中，Hibernate会根据实体类中transactionDate的字段类型（比如标注了@Temporal(TemporalType.DATE)）自动截断时间部分；但原生查询中，Hibernate直接传递Date对象的完整时间戳，不会做额外处理，导致条件匹配出现偏差。

解决方案 #

1. 确保传入的Date参数是当天0点 #

在Java代码中生成参数时，明确设置时分秒为0，避免时区或时间精度问题：

// Java 8+ 推荐使用LocalDate转换
LocalDate targetDate = LocalDate.of(2018, 5, 22);
Date date = Date.from(targetDate.atStartOfDay(ZoneId.systemDefault()).toInstant());

// 兼容旧版本Java的Calendar处理方式
Calendar cal = Calendar.getInstance();
cal.set(2018, Calendar.MAY, 22, 0, 0, 0);
cal.set(Calendar.MILLISECOND, 0);
Date date = cal.getTime();

2. 在原生查询中显式截断时间 #

修改原生查询，将TRANS_DATE和参数都转换为DATE类型，只比较日期部分：

@Query(nativeQuery = true, value = "SELECT SUM(QTY) as QTY, SUM(RETAIL_AMT) as RETAIL_AMT, SUM(DISCOUNT_AMT) as DISCOUNT_AMT, SUM(NET_AMT) as NET_AMT, SUM(COST_AMT) as COST_AMT, SUM(PROFIT) as PROFIT, TRANS_DATE FROM SALE_BY_TRANSACTION where DATE(TRANS_DATE) >= DATE(:date) group by TRANS_DATE")
public List<Object[]> aggregateTransactionsBasedOnDate(@Param("date") Date date);

3. 配置Hibernate时区一致性 #

在application.properties或application.yml中设置Hibernate的JDBC时区，确保参数转换时的时区和数据库一致：

spring.jpa.properties.hibernate.jdbc.time_zone=Asia/Shanghai

验证方法 #

• 打印传入的date参数的具体时间，确认是否为2018-05-22 00:00:00。
• 开启Hibernate的参数绑定日志（添加logging.level.org.hibernate.type.descriptor.sql=TRACE到配置文件），查看实际传入数据库的参数值，确认是否和预期一致。

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