如何在Spring Boot中结合JpaRepository实现Criteria API方法？

方案一：自定义Repository接口+实现类 #

这种方式无需实现JpaRepository的全部方法，仅需扩展自定义方法并实现逻辑即可，完美兼容Spring Data自动生成的CRUD方法。

1. 定义自定义接口
   创建独立接口声明你的多条件查询方法：

public interface UserRepositoryCustom {
    List<User> findUsersByConditions(String name, Integer age, String email);
}

2. 实现自定义接口
   创建实现类，命名需遵循「主Repository接口名+Impl」规则（比如主接口为UserRepository，实现类则为UserRepositoryImpl），在类中用Criteria API实现查询逻辑：

@Repository
public class UserRepositoryImpl implements UserRepositoryCustom {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public List<User> findUsersByConditions(String name, Integer age, String email) {
        CriteriaBuilder cb = entityManager.getCriteriaBuilder();
        CriteriaQuery<User> query = cb.createQuery(User.class);
        Root<User> root = query.from(User.class);

        List<Predicate> predicates = new ArrayList<>();
        // 动态拼接查询条件
        if (name != null && !name.isEmpty()) {
            predicates.add(cb.like(root.get("name"), "%" + name + "%"));
        }
        if (age != null) {
            predicates.add(cb.equal(root.get("age"), age));
        }
        if (email != null && !email.isEmpty()) {
            predicates.add(cb.equal(root.get("email"), email));
        }

        query.where(cb.and(predicates.toArray(new Predicate[0])));
        return entityManager.createQuery(query).getResultList();
    }
}

3. 让主Repository继承自定义接口
   主Repository接口同时继承JpaRepository和自定义接口：

public interface UserRepository extends JpaRepository<User, Long>, UserRepositoryCustom {
    // 保留Spring Data自动生成的CRUD方法
}

使用时直接注入UserRepository，即可像调用自动生成方法一样调用findUsersByConditions。

方案二：使用JpaSpecificationExecutor（灵活动态查询） #

如果需要更灵活的条件组合，推荐结合JpaSpecificationExecutor和Specification接口，无需编写自定义实现类，直接通过Criteria API动态构建条件。

1. 主Repository继承JpaSpecificationExecutor

public interface UserRepository extends JpaRepository<User, Long>, JpaSpecificationExecutor<User> {
}

2. 构建Specification查询条件
   在业务代码中通过Specification动态拼接查询逻辑：

// 根据参数动态生成查询条件
Specification<User> spec = (root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    if (name != null && !name.isEmpty()) {
        predicates.add(cb.like(root.get("name"), "%" + name + "%"));
    }
    if (age != null) {
        predicates.add(cb.equal(root.get("age"), age));
    }
    if (email != null && !email.isEmpty()) {
        predicates.add(cb.equal(root.get("email"), email));
    }
    return cb.and(predicates.toArray(new Predicate[0]));
};

// 执行查询
List<User> users = userRepository.findAll(spec);

这种方式适合条件多变的场景，无需提前在Repository接口中固定方法参数。

为什么不直接实现JpaRepository？ #

直接实现JpaRepository会强制要求你实现所有父接口的方法（如findAll、save等），这完全是冗余工作。Spring Data JPA的设计逻辑就是通过接口继承自动生成基础CRUD方法，自定义方法通过上述两种方式扩展即可避免重复代码。

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