JPA基于双外键查询异常：方法返回空列表但数据库有匹配记录

我来帮你一步步排查这个问题，毕竟数据库明明有符合条件的记录，但查询返回空，大概率是配置或者命名上的小细节出了问题：

1. 先检查方法命名是否符合Spring Data JPA规范 #

Spring Data JPA的查询方法命名是基于实体类的属性名，而非数据库列名。你的实体类里关联属性是private Projects projects;和private Reports reports;（属性名是小写的projects和reports），这里可能存在命名解析的小坑：

正确的命名应该是用下划线明确关联属性的主键：

List<ProjectReportTask> findByProjects_IdAndReports_Id(Long projectId, Long reportId);

虽然Spring Data JPA支持属性名+Id的简写（比如projectsId代表projects.id），但当属性名和实体类名（比如projects和Projects）过于接近时，可能会导致解析混淆，试试下划线分隔的写法，大概率能解决问题。

2. 确认参数顺序是否传反了 #

你的方法定义是findByProjectsIdAndReportsId(Long id, Long id2)，第一个参数对应projectsId，第二个对应reportsId。调用时一定要注意参数顺序：如果数据库中符合条件的记录是projects_id=1、reports_id=2，你却传成了(2,1)，那肯定返回空列表。建议调用时打印一下传入的参数值，和数据库中的记录做对比。

3. 验证实体类的映射配置是否正确 #

• 检查Projects和Reports实体的主键id类型是否为Long，和方法参数类型完全一致。如果主键是Integer但你传了Long，可能会导致隐式转换后不匹配。
• 确认@JoinColumn的配置：
  • name = "projects_id"是否和数据库表中的外键列名完全一致（PostgreSQL默认列名是小写，注意不要和驼峰式命名混淆）；
  • referencedColumnName="id"是否确实是关联实体（Projects/Reports）的主键字段名。
• @ManyToOne的fetch类型（比如FetchType.LAZY）不会影响查询结果，只是加载时机不同，不用太担心这个。

4. 用原生SQL/JPQL绕开命名解析验证 #

如果上面的方法都没解决，可以写一个带@Query注解的查询方法，直接执行原生SQL来验证：

@Query(value = "SELECT * FROM project_report_task WHERE projects_id = ?1 AND reports_id = ?2", nativeQuery = true)
List<ProjectReportTask> findByProjectAndReportIds(Long projectId, Long reportId);

如果这个方法能查到数据，说明是Spring Data JPA的方法命名解析出了问题；如果还是查不到，那就要检查：

• 数据库表名是否正确（比如你的表是不是叫project_report_task，而非其他名字）；
• 传入的参数值是否真的和数据库中的记录匹配（比如是否存在数据类型不匹配，比如数据库是bigint但你传了字符串类型？不过PostgreSQL会自动转换，但还是要确认）。

5. 其他小细节检查 #

• 确认你的Repository接口是否正确继承了JpaRepository或CrudRepository，比如：

  public interface ProjectReportTaskRepository extends JpaRepository<ProjectReportTask, Long> {
      // 你的查询方法
  }
  

  如果没有继承这些接口，Spring不会为你生成查询实现类，调用方法时自然得不到正确结果。
• 检查查询是否在正确的事务中执行，比如可以给查询方法加上@Transactional(readOnly = true)，避免事务隔离级别导致的查询问题。

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