调用JpaSpecificationExecutor的findAll方法报错：无Specifications默认构造方法

你遇到的这个报错其实很典型，根源就出在Controller方法里直接把Specifications<Employee>作为请求参数了。Spring MVC在处理请求时，会尝试自动实例化这个参数，但org.springframework.data.jpa.domain.Specifications类根本没有公开的无参构造方法——它的构造方法是私有的，只能通过Specifications.where()这类静态方法来创建实例，所以Spring没法通过反射来实例化它，自然就抛出了NoSuchMethodException。

正确的实现步骤 #

1. 先定义查询参数DTO #

首先要创建一个用来接收前端查询条件的DTO类，把你需要的查询字段都放进去：

public class EmployeeQueryDTO {
    private String ename;
    private Date hireDateStart;
    private Date hireDateEnd;
    private Long minSalary;
    private Long maxSalary;
    private String skills;

    // 务必添加所有字段的getter和setter方法
}

2. 修改Controller方法 #

把Controller里的Specifications<Employee>参数换成刚才的DTO，让Spring MVC先把请求参数绑定到这个DTO上，再传递给Service：

@RequestMapping(method = RequestMethod.GET)
public Page<Employee> getEmployees(EmployeeQueryDTO queryDTO, Pageable pageable) {
    return this.employeeService.getEmployees(queryDTO, pageable);
}

3. 在Service中动态构建Specifications #

接下来在Service层，根据DTO里的查询条件，用Specifications的静态方法来构建查询规范：

public Page<Employee> getEmployees(EmployeeQueryDTO queryDTO, Pageable pageable) {
    // 初始化一个空的Specifications
    Specifications<Employee> specs = Specifications.where(null);

    // 根据姓名模糊查询
    if (queryDTO.getEname() != null && !queryDTO.getEname().isBlank()) {
        specs = specs.and((root, query, cb) -> cb.like(root.get("ename"), "%" + queryDTO.getEname() + "%"));
    }

    // 入职日期范围查询
    if (queryDTO.getHireDateStart() != null) {
        specs = specs.and((root, query, cb) -> cb.greaterThanOrEqualTo(root.get("hireDate"), queryDTO.getHireDateStart()));
    }
    if (queryDTO.getHireDateEnd() != null) {
        specs = specs.and((root, query, cb) -> cb.lessThanOrEqualTo(root.get("hireDate"), queryDTO.getHireDateEnd()));
    }

    // 薪资范围查询
    if (queryDTO.getMinSalary() != null) {
        specs = specs.and((root, query, cb) -> cb.greaterThanOrEqualTo(root.get("salary"), queryDTO.getMinSalary()));
    }
    if (queryDTO.getMaxSalary() != null) {
        specs = specs.and((root, query, cb) -> cb.lessThanOrEqualTo(root.get("salary"), queryDTO.getMaxSalary()));
    }

    // 技能模糊查询
    if (queryDTO.getSkills() != null && !queryDTO.getSkills().isBlank()) {
        specs = specs.and((root, query, cb) -> cb.like(root.get("skills"), "%" + queryDTO.getSkills() + "%"));
    }

    return employeeRepository.findAll(specs, pageable);
}

4. 同步更新Service接口 #

记得把Service接口里的方法签名也改了，把参数从Specifications<Employee>替换成EmployeeQueryDTO。

额外说明 #

Specifications本质上是一个用来组合JPA查询条件的工具类，它的设计初衷就是通过静态工厂方法来创建和组合实例，而不是让框架直接实例化。所以永远不要把它作为Controller的请求参数，而是应该在服务层根据前端传递的查询条件动态构建。

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