Spring Boot中JPA结合Specification、分页查询报错排查

首先，你遇到的错误 "Either use @Param on all parameters except Pageable and Sort typed once, or none at all!" 是Spring Data JPA的参数绑定规则导致的：当你在自定义查询方法中混合使用了带@Param标注的参数和未标注的参数（这里的Specification参数没有加@Param），就会触发这个异常。Spring要求要么所有非Pageable/Sort类型的参数都用@Param标注，要么全部不用（使用位置参数）。

第一步：修复参数标注问题 #

你有两种方式解决这个参数标注冲突：

方式1：给Specification参数也添加@Param标注

修改你的Repository方法，给Specification参数加上@Param：

@Repository
public interface XrayVulnerabilityRepository extends PagingAndSortingRepository<XrayVulnerabilityEntity,XrayVulnerabilityPK> , JpaSpecificationExecutor<XrayVulnerabilityEntity>{
 @Query("SELECT x FROM XrayVulnerabilityEntity x,DomainArtifactEntity d WHERE d.domainOrgName=:domainOrgNameParam AND x.domainArtifactId=d")
 public Page<XrayVulnerabilityEntity> findAll(@Param(value = "domainOrgNameParam") String domainOrgName, @Param("spec") Specification<XrayVulnerabilityEntity> spec, Pageable pageable);

 @Query("SELECT COUNT(x) FROM XrayVulnerabilityEntity x,DomainArtifactEntity d WHERE d.domainOrgName=:domainOrgNameParam AND x.domainArtifactId=d")
 public Long getCount(@Param(value = "domainOrgNameParam") String domainOrgName, @Param("spec") Specification<XrayVulnerabilityEntity> spec);
}

方式2：移除所有@Param，使用位置参数

把@Param去掉，用?1、?2这样的位置占位符：

@Repository
public interface XrayVulnerabilityRepository extends PagingAndSortingRepository<XrayVulnerabilityEntity,XrayVulnerabilityPK> , JpaSpecificationExecutor<XrayVulnerabilityEntity>{
 @Query("SELECT x FROM XrayVulnerabilityEntity x,DomainArtifactEntity d WHERE d.domainOrgName=?1 AND x.domainArtifactId=d")
 public Page<XrayVulnerabilityEntity> findAll(String domainOrgName, Specification<XrayVulnerabilityEntity> spec, Pageable pageable);

 @Query("SELECT COUNT(x) FROM XrayVulnerabilityEntity x,DomainArtifactEntity d WHERE d.domainOrgName=?1 AND x.domainArtifactId=d")
 public Long getCount(String domainOrgName, Specification<XrayVulnerabilityEntity> spec);
}

第二步：优化JPQL查询（更优雅的写法） #

你的JPQL用了笛卡尔积的写法，其实可以利用XrayVulnerabilityEntity和DomainArtifactEntity之间的@ManyToOne关联，简化查询语句，可读性更好：

@Query("SELECT x FROM XrayVulnerabilityEntity x WHERE x.domainArtifactId.domainOrgName = :domainOrgNameParam")
public Page<XrayVulnerabilityEntity> findAll(@Param(value = "domainOrgNameParam") String domainOrgName, @Param("spec") Specification<XrayVulnerabilityEntity> spec, Pageable pageable);

@Query("SELECT COUNT(x) FROM XrayVulnerabilityEntity x WHERE x.domainArtifactId.domainOrgName = :domainOrgNameParam")
public Long getCount(@Param(value = "domainOrgNameParam") String domainOrgName, @Param("spec") Specification<XrayVulnerabilityEntity> spec);

这种写法直接通过实体的关联属性domainArtifactId.domainOrgName查询，避免了显式的表连接，更符合JPA的设计思想。

第三步：验证Specification的正确作用 #

需要注意的是，你自定义的查询方法中，Specification会作用于你写的JPQL基础查询之上。也就是说，Spring Data JPA会把Specification生成的查询条件和你JPQL中的条件进行AND组合，最终生成完整的SQL语句。

如果你希望Specification能灵活组合条件（比如OR逻辑），这个写法是没问题的，但要确保Specification中使用的属性路径和实体类的属性一致。

额外建议：利用JpaSpecificationExecutor的原生方法 #

其实JpaSpecificationExecutor已经提供了带Specification的分页查询方法：

Page<T> findAll(@Nullable Specification<T> spec, Pageable pageable);

如果你想结合domainOrgName的条件，完全可以把这个条件写到Specification中，而不用自定义查询方法，这样更简洁：

// 调用时构建包含domainOrgName条件的Specification
Specification<XrayVulnerabilityEntity> spec = (root, query, cb) -> {
    Predicate domainPredicate = cb.equal(root.get("domainArtifactId").get("domainOrgName"), domainOrgName);
    // 可以添加其他条件
    return domainPredicate;
};
Page<XrayVulnerabilityEntity> page = xrayVulnerabilityRepository.findAll(spec, pageable);

这种方式不需要自定义Repository方法，完全通过Specification组合所有条件，更符合Spring Data JPA的规范。

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