Spring Data JPA中如何基于多关键词列表实现多字段的包含查询

首先，你遇到的编译失败问题是因为JPA的方法命名规则里并没有ContainsIsIn这种组合语法——Contains对应模糊匹配（LIKE）查询，IsIn对应IN子句，两者不能直接拼接使用，所以第二个方法无法通过编译。

针对多关键词分散在title和blurb字段的检索需求，这里有几个可行的方案：

方案一：使用JPA Specification动态构建查询 #

这是最灵活的方案，尤其适合关键词数量不固定的场景。

1. 先让你的BookRepository继承JpaSpecificationExecutor<Book>接口：

public interface BookRepository extends JpaRepository<Book, Long>, JpaSpecificationExecutor<Book> {
}

2. 编写一个静态方法来构建检索条件：

public class BookSpecifications {
    public static Specification<Book> matchesAllKeywords(List<String> keywords) {
        return (root, query, criteriaBuilder) -> {
            // 每个关键词都要满足「title包含 OR blurb包含」，所有关键词的条件用AND连接
            List<Predicate> keywordPredicates = new ArrayList<>();
            for (String keyword : keywords) {
                Predicate titleMatch = criteriaBuilder.like(
                    root.get("title"), 
                    criteriaBuilder.concat("%", criteriaBuilder.concat(keyword, "%"))
                );
                Predicate blurbMatch = criteriaBuilder.like(
                    root.get("blurb"), 
                    criteriaBuilder.concat("%", criteriaBuilder.concat(keyword, "%"))
                );
                keywordPredicates.add(criteriaBuilder.or(titleMatch, blurbMatch));
            }
            // 将所有关键词的条件组合成AND关系（如果需要任意关键词匹配，改成or即可）
            return criteriaBuilder.and(keywordPredicates.toArray(new Predicate[0]));
        };
    }
}

3. 在业务代码中调用：

List<String> keywords = Arrays.asList("java", "入门");
Iterable<Book> books = bookRepository.findAll(BookSpecifications.matchesAllKeywords(keywords));

这个方案会生成类似这样的SQL：

SELECT * FROM book 
WHERE (title LIKE '%java%' OR blurb LIKE '%java%') 
  AND (title LIKE '%入门%' OR blurb LIKE '%入门%')

方案二：使用自定义Repository+EntityManager构建动态JPQL #

如果你不想用Specification，也可以通过EntityManager手动构建JPQL查询：

1. 定义自定义Repository接口：

public interface BookCustomRepository {
    Iterable<Book> findByKeywords(List<String> keywords);
}

2. 实现这个自定义接口：

@Repository
public class BookCustomRepositoryImpl implements BookCustomRepository {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public Iterable<Book> findByKeywords(List<String> keywords) {
        StringBuilder jpql = new StringBuilder("SELECT b FROM Book b WHERE 1=1");
        List<String> paramValues = new ArrayList<>();
        
        for (int i = 0; i < keywords.size(); i++) {
            String paramName = "keyword" + i;
            jpql.append(" AND (b.title LIKE CONCAT('%', :" + paramName + ", '%') OR b.blurb LIKE CONCAT('%', :" + paramName + ", '%'))");
            paramValues.add(keywords.get(i));
        }
        
        TypedQuery<Book> query = entityManager.createQuery(jpql.toString(), Book.class);
        for (int i = 0; i < paramValues.size(); i++) {
            query.setParameter("keyword" + i, paramValues.get(i));
        }
        
        return query.getResultList();
    }
}

3. 让主Repository继承自定义接口：

public interface BookRepository extends JpaRepository<Book, Long>, BookCustomRepository {
}

方案三：利用MariaDB全文索引优化性能（进阶） #

如果你的图书数据量较大，LIKE查询的性能会很差，建议给title和blurb字段添加全文索引：

ALTER TABLE book ADD FULLTEXT INDEX idx_book_title_blurb (title, blurb);

之后可以用全文检索语法替代LIKE，比如修改Specification中的条件：

Predicate fullTextMatch = criteriaBuilder.equal(
    criteriaBuilder.function(
        "MATCH", Integer.class, root.get("title"), root.get("blurb")
    ),
    criteriaBuilder.function(
        "AGAINST", Integer.class, criteriaBuilder.literal(keyword), criteriaBuilder.literal("IN BOOLEAN MODE")
    )
);
keywordPredicates.add(fullTextMatch);

这样生成的SQL会使用MATCH(title, blurb) AGAINST('keyword' IN BOOLEAN MODE)，性能比LIKE提升很多，还支持更复杂的检索语法（比如+关键词表示必须包含，-关键词表示排除）。

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