Spring Boot JPA自定义JPQL查询无返回结果排查求助

可能的原因及对应解决方法 #

1. JPQL查询的字段/实体匹配问题 #

虽然你的JPQL语句看起来没问题，但要确认：

• 数据库中username列的实际大小写是否和实体类字段一致。部分数据库（如PostgreSQL、Linux环境下的MySQL）对表名/列名大小写敏感，如果数据库列是USERNAME，而实体字段是username，会导致匹配失败。
• 解决办法：统一实体字段和数据库列的大小写，或在实体类的username字段上显式指定列名：

  @Column(name = "username", nullable = false) // name对应数据库实际列名
  private String username;
  

2. 查询参数存在格式问题 #

检查传入的username参数是否包含前后空格、特殊字符，而数据库中存储的是无空格的内容，导致匹配不上。

• 解决办法：在调用查询前对参数做trim处理：

  public AdminInfo getAdminByUsername(String username) {
      AdminInfo admin = adminRepository.getByUsername(username.trim());
      return admin;
  }
  

3. 开启SQL日志排查实际执行语句 #

控制台无错误提示时，建议开启Hibernate的SQL日志，查看实际执行的SQL语句和绑定的参数，确认是否和预期一致。

• 在application.properties中添加配置：

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

  启动程序后，控制台会打印执行的SQL及参数值，对比数据库数据即可快速定位问题。

4. 改用Spring Data JPA自动生成查询方法 #

自定义JPQL易出错，Spring Data JPA支持根据方法名自动生成查询，可靠性更高。修改AdminRepository：

public interface AdminRepository extends JpaRepository<AdminInfo, Long>{
    // 移除@Query注解，使用方法名规则自动生成查询
    AdminInfo findByUsername(String username);
}

控制器中调用该方法即可，避免JPQL拼写错误。

5. 检查线程阻塞与事务问题 #

如果程序执行到查询语句处停止，需确认：

• 数据库连接池是否正常，是否存在连接耗尽情况；
• 若在事务中执行查询，需确保事务未被挂起或等待锁。

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