Spring JPA中@Query带JOIN FETCH和Pageable查询集合对象失效问题
问题原因
为什么List可以正常返回,Page就报错?
不带Pageable的列表查询时,Hibernate会直接执行你写的JPQL语句,你已经给两次关联postTags的操作分别指定了别名pts、pts2,所有对关联集合属性的引用都是通过别名调用,语法完全合法,所以可以正常执行。
而当你传入Pageable做分页查询时,Spring Data JPA会自动改造你的原查询语句,生成带偏移/条数限制的子查询结构,改造过程中会丢失部分别名绑定,直接引用Post实体的postTags集合属性写条件,相当于直接执行po.postTags.someDateField这类语法,而postTags是集合类型,不能直接点选元素属性,就触发了你遇到的异常。
另外你的代码本身还有三处隐藏问题,也会导致查询不稳定:
Post实体@OneToMany的mappedBy属性配置错误,你写的是"Post"(大写开头),但PostTag实体里对应的关联属性名是小写的post,关联映射本身不匹配- JPQL里的属性名和实体定义大小写不符:
Post里的集合是postTags,你写的是posttags;Items里的集合是subItems,你写的是subitems,部分ORM框架对属性名大小写敏感 - 你写的
countQuery里带了order by子句,完全没有必要,count查询不需要排序,反而会额外增加性能开销
解决方案
方案1:分页ID查询+关联查询组装(最稳妥,兼容所有版本)
避免把Pageable和带FETCH JOIN的查询直接绑定,拆分两步查询:
- 先分页查询符合条件的Post主键列表:
@Query(value = "select distinct po.postId from Post po " + "INNER JOIN po.postTags pts " + "INNER JOIN pts.tag t " + "INNER JOIN pts.items i " + "INNER JOIN i.subItems " + "where t.tagName like :tName and pts.someDateField between :startDate and :endDate " + "order by pts.someDateField desc", countQuery = "select count(distinct po.postId) from Post po " + "INNER JOIN po.postTags pts " + "INNER JOIN pts.tag t " + "INNER JOIN pts.items i " + "INNER JOIN i.subItems " + "where t.tagName like :tName and pts.someDateField between :startDate and :endDate") Page<String> findPostIdsByCondition(String tName, String startDate, String endDate, Pageable pageable);
- 再根据主键列表批量查询带所有关联的Post数据:
@Query("select distinct po from Post po " + "INNER JOIN FETCH po.postTags pts " + "INNER JOIN FETCH pts.tag t " + "INNER JOIN FETCH pts.items i " + "INNER JOIN FETCH i.subItems " + "where po.postId in :postIds") List<Post> findAllPostWithAssociationsByIds(@Param("postIds") Collection<String> postIds);
- 业务层手动组装成
Page<Post>即可:
Page<String> idPage = postRepo.findPostIdsByCondition(tName, startDate, endDate, pageable); List<Post> postList = postRepo.findAllPostWithAssociationsByIds(idPage.getContent()); Page<Post> postPage = new PageImpl<>(postList, pageable, idPage.getTotalElements());
方案2:适配高版本Hibernate配置
如果你使用Hibernate 5.2以上版本,可以在配置文件中开启如下配置,同时在你的原查询JPQL中加上distinct关键字,修正属性名大小写和mappedBy配置后,也可以直接用分页查询:
spring.jpa.properties.hibernate.query.pass_distinct_through=true
同时修正原查询的拼写错误,去掉countQuery里的order by即可。
内容的提问来源于stack exchange,提问作者Satscreate
相关产品推荐
相关产品推荐

