Spring Data Jpa中使用命名查询关联两表时分页功能失效问题

问题原因 #

1. LEFT JOIN FETCH导致结果重复：使用LEFT JOIN FETCH加载关联集合时，查询结果会因每条关联记录生成重复的主实体行，Spring Data JPA的分页基于该重复结果集计算，导致分页逻辑错误。
2. 无外键关联导致JPQL映射失效：JPA默认依赖实体类上的@OneToMany/@ManyToOne等关联注解，这类注解通常需要数据库外键支持，无外键时JPQL的关联查询（如v.comments）无法被正确解析。

解决方案 #

方案一：原生SQL实现分页（推荐无外键场景） #

直接用原生SQL编写关联查询，同时单独指定去重后的统计总条数查询，Spring Data JPA会自动处理分页参数。

@Query(
    value = "SELECT v.* FROM tbl_visits v LEFT JOIN tbl_comments c ON v.id = c.visit_id WHERE v.venue_id = :venueId",
    countQuery = "SELECT COUNT(DISTINCT v.id) FROM tbl_visits v LEFT JOIN tbl_comments c ON v.id = c.visit_id WHERE v.venue_id = :venueId",
    nativeQuery = true
)
public Page<VisitEntity> getVenueVisits(@Param("venueId") long venueId, Pageable pageable);

关键说明：

• nativeQuery = true：启用原生SQL查询，绕过JPA实体关联映射，适配无外键场景。
• countQuery：必须单独定义统计查询，用COUNT(DISTINCT v.id)排除JOIN产生的重复行，保证总条数是实际的主实体数量。
• Spring Data JPA会自动将Pageable参数转换为对应数据库的分页语法（如MySQL的LIMIT/OFFSET）。

方案二：调整JPQL写法（适用于已配置实体关联的场景） #

如果实体类已手动配置关联注解（即使数据库无外键），可以去掉LEFT JOIN FETCH，改用普通LEFT JOIN，结合实体图批量加载关联数据避免N+1查询。

@EntityGraph(attributePaths = {"comments"})
@Query("SELECT v FROM VisitEntity v WHERE v.venue.id = :venueId")
public Page<VisitEntity> getVenueVisits(@Param("venueId") long venueId, Pageable pageable);

关键说明：

• 去掉LEFT JOIN FETCH后，查询结果无重复，分页逻辑正常。
• @EntityGraph：指定批量加载comments关联集合，避免后续延迟加载产生的N+1查询问题。
• 若实体未配置关联注解，JPQL的关联查询会失效，此时优先选择原生SQL方案。

注意事项 #

• 关联查询分页时，必须保证查询结果的唯一性，否则分页的总条数和页码会出现偏差。
• 无外键关联场景下，原生SQL是最可靠的实现方式，无需依赖JPA的实体关联映射逻辑。

内容的提问来源于stack exchange，提问作者P V REDDY