如何在Spring JPA中使用Query-By-Example实现IN子句查询？

这个问题我之前也碰到过，Query-By-Example（QBE）确实方便，但对IN这种多值匹配的支持确实不够直接——因为它本质是基于单个实体实例的属性值生成等值查询条件，天然不支持多值的IN/OR组合。这里给你几个可行的解决办法：

1. 结合Specification与Example（保留QBE原有逻辑） #

如果你的查询还需要保留QBE的其他匹配规则（比如同时匹配其他属性的等值条件），可以用Specification来扩展IN条件，同时结合Example的逻辑。

首先，你的DAO接口需要继承JpaSpecificationExecutor<Person>：

public interface PersonDao extends JpaRepository<Person, Long>, JpaSpecificationExecutor<Person> {
}

然后编写查询代码：

import org.springframework.data.jpa.domain.Example;
import org.springframework.data.jpa.domain.Specification;
import java.util.Arrays;
import java.util.List;

public List<Person> queryWithInClause() {
    // 1. 先创建QBE的probe和Example（如果需要其他等值条件）
    Person probe = new Person();
    // 比如这里可以添加其他QBE匹配条件，比如probe.setAge(30);
    Example<Person> example = Example.of(probe);

    // 2. 构建Specification来添加IN条件
    Specification<Person> nameInSpec = (root, query, cb) -> {
        List<String> targetNames = Arrays.asList("john", "jane");
        return root.get("name").in(targetNames);
    };

    // 3. 结合Example和Specification执行查询
    return dao.findAll(Specification.where(nameInSpec).and(ExampleSpecification.of(example)));
}

2. 使用Spring Data JPA方法命名查询（最简单） #

如果你的查询只需要IN条件，不需要其他QBE逻辑，直接用方法命名规则最省事：

在DAO接口中定义方法：

public interface PersonDao extends JpaRepository<Person, Long> {
    List<Person> findByNameIn(List<String> names);
}

调用时直接传入名字列表：

public List<Person> query() {
    return dao.findByNameIn(Arrays.asList("john", "jane"));
}

3. 使用@Query注解自定义JPQL #

如果需要更灵活的查询逻辑，也可以直接用JPQL写查询语句：

在DAO接口中添加注解方法：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface PersonDao extends JpaRepository<Person, Long> {
    @Query("SELECT p FROM Person p WHERE p.name IN :names")
    List<Person> findByNamesIn(@Param("names") List<String> names);
}

调用方式和方法命名查询类似：

public List<Person> query() {
    return dao.findByNamesIn(Arrays.asList("john", "jane"));
}

总结一下：QBE本身不支持IN子句，所以需要结合Spring JPA的其他特性来实现。如果要保留QBE的原有匹配逻辑，就用Specification+Example；如果只是单纯的IN查询，方法命名或@Query注解会更简单。

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