JPA Pageable查询返回Page<PostComment>时出现语法错误求助

问题根源 #

当方法返回Page<PostComment>时，Spring Data JPA会自动生成count查询语句以获取总记录数，但原JPQLSELECT p.postComments FROM Post p WHERE p.webId = ?1直接查询Post实体的集合属性，Hibernate在生成count语句时无法正确解析集合路径的语法，导致SQL报错。

解决方案（两种可选） #

方案1：直接查询PostComment实体（推荐） #

既然最终需要的是PostComment的分页数据，直接从PostComment实体出发，通过关联的Post对象过滤条件，这种写法更符合JPA查询规范，也能自动生成正确的count语句。

假设PostComment实体中存在@ManyToOne private Post post;关联字段，修改Repository方法如下：

@Repository
public interface PostRepository extends PagingAndSortingRepository<Post, Long> {

    @Query("SELECT pc FROM PostComment pc WHERE pc.post.webId = ?1")
    Page<PostComment> findCommentsByWebId(String webid, Pageable pageable);

}

方案2：手动指定count查询语句 #

如果坚持从Post实体的集合属性查询，需要显式指定count查询的JPQL，避免自动生成的错误语法：

@Repository
public interface PostRepository extends PagingAndSortingRepository<Post, Long> {

    @Query(value = "SELECT p.postComments FROM Post p WHERE p.webId = ?1",
           countQuery = "SELECT COUNT(pc) FROM Post p JOIN p.postComments pc WHERE p.webId = ?1")
    Page<PostComment> findCommentsByWebId(String webid, Pageable pageable);

}

说明 #

两种方案都能解决SQL语法错误问题，同时实现分页查询和总元素数量统计的需求。方案1逻辑更直接，是更推荐的写法。

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