Spring JPA Query by Example：如何查询名为James且同时拥有法拉利和兰博基尼的用户？

首先直接给结论：你提供的这段QBE代码无法达成需求，而且还存在一些小问题，我来详细拆解原因和解决方案。

为什么你的QBE代码不行？ #

Spring JPA的QBE是基于你创建的实体实例生成查询条件，但它对集合属性（比如ownedCars）的默认匹配逻辑是OR语义，而非你需要的AND语义：

• 你创建的Person实例里添加了兰博基尼和法拉利，QBE会生成类似“拥有兰博基尼 OR 拥有法拉利”的条件，而不是“同时拥有两者”。
• 另外，你的代码里有个小bug：Person类定义里没有setName方法，应该是setFirstname或者setLastname（比如p.setFirstname("James")）。

更本质的问题是：QBE设计的初衷是快速生成简单的单实体查询，它并不支持对关联集合的“多元素同时存在”这类复杂匹配需求。

正确的实现方式 #

要实现“名为James且同时拥有法拉利和兰博基尼”的查询，你有两种靠谱的方案：

方案1：使用JPQL查询 #

这是最直接的方式，通过显式关联查询来实现AND条件：

@Repository
public interface PersonRepository extends JpaRepository<Person, String> {

    @Query("SELECT DISTINCT p FROM Person p " +
           "JOIN p.ownedCars c1 " +
           "JOIN p.ownedCars c2 " +
           "WHERE p.firstname = :firstname " +
           "AND c1.make = :carMake1 " +
           "AND c2.make = :carMake2")
    List<Person> findByFirstnameAndOwnedCarsContainsBoth(
        @Param("firstname") String firstname,
        @Param("carMake1") String carMake1,
        @Param("carMake2") String carMake2
    );
}

• 加DISTINCT是为了避免同一个Person因为两次JOIN而被重复返回。
• 使用命名参数让代码更清晰，也更容易复用。

调用的时候就很简单了：

List<Person> jamesWithBothCars = personRepository.findByFirstnameAndOwnedCarsContainsBoth(
    "James", "Lamborghini", "Ferrari"
);

方案2：使用Specification扩展查询 #

如果想保持类型安全的查询方式（避免硬写JPQL字符串），可以用Spring Data JPA的Specification接口来构建复杂条件：

public class PersonSpecifications {

    // 生成“拥有指定品牌汽车”的条件
    public static Specification<Person> hasCarMake(String make) {
        return (root, query, cb) -> {
            // 开启去重，避免重复结果
            query.distinct(true);
            Join<Person, Car> carJoin = root.join("ownedCars");
            return cb.equal(carJoin.get("make"), make);
        };
    }

    // 生成“名字匹配”的条件
    public static Specification<Person> firstnameEquals(String firstname) {
        return (root, query, cb) -> cb.equal(root.get("firstname"), firstname);
    }
}

然后组合这些条件查询：

List<Person> jamesWithBothCars = personRepository.findAll(
    Specification.where(PersonSpecifications.firstnameEquals("James"))
       .and(PersonSpecifications.hasCarMake("Lamborghini"))
       .and(PersonSpecifications.hasCarMake("Ferrari"))
);

这种方式的好处是可以灵活组合各种查询条件，适合复杂多变的查询场景。

总结 #

QBE不适合处理“集合同时包含多个元素”的查询需求，它更擅长简单的单实体属性匹配。如果你需要这种复杂的关联AND查询，JPQL或者Specification是更合适的选择。

内容的提问来源于stack exchange，提问作者Matúš Zbojník