Spring Data JPA：Specifications<T>已过时及多列查询代码报错求助

问题原因分析 #

你遇到的两个错误是关联的：

1. Specifications类已被弃用：从Spring Data JPA 2.x版本开始，org.springframework.data.jpa.domain.Specifications就被标记为过时，官方推荐直接使用Specification接口的实现，不再需要通过Specifications工具类来构建查询条件。
2. 方法参数不匹配：过时的Specifications.where()方法签名和当前Specification接口的实现存在兼容性问题，而且JpaRepository的findAll()方法本身就支持直接接收Specification参数，完全不需要额外包装。

解决方案 #

我们可以通过两步来修复问题：

1. 简化EmployeeSpecification的实现（用Lambda替代匿名内部类）

因为Specification是函数式接口，我们可以用Lambda表达式简化代码，同时保留原有的多列模糊搜索逻辑：

public class EmployeeSpecification {
    public static Specification<Employee> textInAllColumns(String text) {
        // 统一处理模糊匹配的通配符
        String finalText = text.contains("%") ? text : "%" + text + "%";
        
        return (root, cq, builder) -> builder.or(
            root.getModel().getDeclaredSingularAttributes().stream()
                // 只过滤String类型的属性
                .filter(attr -> String.class.equals(attr.getJavaType()))
                // 为每个String属性构建like条件
                .map(attr -> builder.like(root.get(attr.getName()), finalText))
                .toArray(Predicate[]::new)
        );
    }
}

2. 修改Service层代码，直接传递Specification实例

移除对Specifications类的依赖，直接将EmployeeSpecification生成的条件传递给findAll()方法，同时建议使用构造器注入代替@Autowired（Spring官方推荐的最佳实践）：

@Service
@Slf4j
public class EmployeeServiceImpl implements EmployeeService {
    private final EmployeeRepository employeeRepository;

    // 构造器注入，避免空指针，更利于单元测试
    public EmployeeServiceImpl(EmployeeRepository employeeRepository) {
        this.employeeRepository = employeeRepository;
    }

    @Override
    public List<Employee> findAllCustomersByFirstName(String firstName) {
        // 直接传入Specification实例即可
        return employeeRepository.findAll(EmployeeSpecification.textInAllColumns(firstName));
    }
}

额外说明

• 如果你需要组合多个Specification条件（比如同时按FirstName和LastName搜索），可以直接使用Specification接口的and()/or()默认方法，例如：

  Specification<Employee> spec = EmployeeSpecification.textInAllColumns(firstName)
      .and(EmployeeSpecification.textInAllColumns(lastName));
  

• 原代码中root.getModel().getDeclaredSingularAttributes()会获取实体类的所有单值属性，我们通过filter只保留String类型，确保模糊搜索只应用在文本字段上，逻辑是正确的。

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