Spring Boot JPA @Query查询MySQL返回结果异常问题排查

结合你的代码、现象以及MySQL和PostgreSQL的特性差异，我梳理了几个最可能的原因及对应的解决办法：

1. 时区不一致导致的日期转换偏差 #

这是此类问题最常见的诱因：Spring Boot应用服务器的时区和MySQL服务器的时区不匹配，导致Java传递的Date参数被转换后，和数据库中存储的日期产生偏移。

举个例子：如果你的应用使用UTC时区，而MySQL服务器使用东8区（Asia/Shanghai），Java中2020-02-28这个日期会被转换成MySQL时区的2020-02-28 08:00:00。此时查询条件FECHA_FIN <= ?会出现逻辑偏差——部分中间日期的记录可能因为时区转换后超出范围而被过滤，最终只留下边界日期的结果。

解决办法：

• 在Spring Boot配置文件（application.properties/application.yml）中指定Hibernate的JDBC时区，确保和MySQL服务器一致：

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

  （替换为你的MySQL服务器实际使用的时区，比如UTC）
• 同时确认MySQL服务器的时区配置，可执行SELECT @@global.time_zone;查看。

2. java.util.Date的时间部分干扰 #

java.util.Date本质是带时间戳的类型，即使你在Entity上加了@Temporal(TemporalType.DATE)，MySQL JDBC驱动仍可能将其当作Timestamp处理，隐含的时间部分（比如00:00:00）会和数据库的纯Date字段产生意外的比较结果。而PostgreSQL对这种场景的处理更宽松，所以能正常返回数据。

解决办法：改用Java 8的LocalDate类型（纯日期、无时间部分），完全贴合数据库Date字段的特性：

• 修改Entity类的日期字段：

  @Entity 
  @Table(name = "`Table`") // 注意：Table是MySQL关键字，用反引号包裹避免语法问题
  public class Table{ 
      // 其他字段保持不变
      @Column(name = "FECHA_INICIO") 
      @NotNull 
      private LocalDate fechaInicio; 
  
      @Column(name = "FECHA_FIN") 
      @NotNull 
      private LocalDate fechaFin; 
      // 其他字段保持不变
  }
  

• 修改Repository的方法参数：

  public interface TableRepository extends CrudRepository<Table, String> { 
      @Query(value = "SELECT * FROM `Table` WHERE FECHA_INICIO >= :fechaInicio AND FECHA_FIN <= :fechaFin", nativeQuery = true) 
      List<Table> findAllBetweenDates(@Param("fechaInicio") LocalDate fechaInicio, @Param("fechaFin") LocalDate fechaFin); 
  }
  

  这样传递的参数是纯日期，彻底避免时间部分和时区转换的干扰。

3. MySQL JDBC驱动版本问题 #

旧版本的MySQL JDBC驱动（比如5.x系列）对Java日期类型的支持存在bug，尤其是在Date参数转换环节。而PostgreSQL的驱动对日期类型的处理更成熟，所以不会出现异常。

解决办法：升级MySQL JDBC驱动到最新的8.x稳定版，比如在pom.xml中：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version> <!-- 替换为最新稳定版本 -->
</dependency>

4. 原生SQL中关键字未转义 #

Table是MySQL的保留关键字，虽然WorkBench会自动处理转义，但Hibernate执行原生查询时如果不用反引号包裹表名，可能会导致隐性的语法解析问题，间接影响查询结果。

解决办法：在原生SQL中用反引号包裹表名（如上面示例中的\Table``）。

临时调试方案 #

如果以上方法仍未解决问题，你可以开启Hibernate的参数绑定日志，查看实际传递给MySQL的参数值，确认是否和预期一致：
在配置文件中添加：

logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

这样就能看到每个?对应的实际参数内容，帮你定位问题根源。

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