PostgreSQL与Spring环境下多列多关键词搜索实现求助

方法1：拆分关键词逐个匹配（简单易实现） #

核心思路是把用户输入的filter按空格拆分成多个关键词，要求每个关键词都能在任意指定字段中找到匹配（即每个关键词满足「字段1包含它 OR 字段2包含它 OR ...」，再将所有关键词的条件用AND连接）。

实现步骤： #

• 拆分并预处理关键词：将输入字符串按空格分割，过滤空字符串，统一转小写。
• 用JPA CriteriaBuilder动态构建查询，对每个关键词添加OR条件，再将所有关键词的条件用AND组合。

代码示例： #

import jakarta.persistence.criteria.Predicate;
import org.springframework.data.jpa.domain.Specification;

public class ContactSpecifications {
    public static Specification<Contacts> filterByMultiKeywords(String filter) {
        return (root, query, cb) -> {
            if (filter == null || filter.trim().isEmpty()) {
                return cb.conjunction(); // 返回所有数据
            }
            // 拆分关键词，处理连续空格
            String[] keywords = filter.trim().toLowerCase().split("\\s+");
            Predicate[] keywordPredicates = new Predicate[keywords.length];
            
            for (int i = 0; i < keywords.length; i++) {
                String keyword = "%" + keywords[i] + "%";
                // 单个关键词的多字段OR匹配条件
                Predicate supplierNoMatch = cb.like(cb.lower(cb.toString(root.get("supplierNo"))), keyword);
                Predicate firstNameMatch = cb.like(cb.lower(root.get("firstName")), keyword);
                Predicate lastNameMatch = cb.like(cb.lower(root.get("lastName")), keyword);
                Predicate supplierNameMatch = cb.like(cb.lower(root.get("supplierName")), keyword);
                
                keywordPredicates[i] = cb.or(supplierNoMatch, firstNameMatch, lastNameMatch, supplierNameMatch);
            }
            // 所有关键词条件必须同时满足
            return cb.and(keywordPredicates);
        };
    }
}

在Repository中继承JpaSpecificationExecutor<Contacts>后，调用方式：

List<Contacts> contacts = contactRepository.findAll(ContactSpecifications.filterByMultiKeywords("John Smith"));

方法2：利用PostgreSQL全文搜索（高性能适配大数据量） #

如果数据量较大，LIKE查询性能不足，可以借助PostgreSQL的全文搜索功能，将需要搜索的字段合并为全文索引，再用tsquery匹配多关键词。

实现步骤： #

1. 先在数据库中创建全文索引（可选，大幅提升查询速度）：

CREATE INDEX idx_contacts_fulltext ON contacts USING gin (
    to_tsvector('english', 
        cast(supplierNo as text) || ' ' || 
        firstName || ' ' || 
        lastName || ' ' || 
        supplierName
    )
);

2. 编写原生SQL查询：

@Query(value = "SELECT c.* FROM contacts c " +
        "WHERE to_tsvector('english', cast(c.supplierNo as text) || ' ' || c.firstName || ' ' || c.lastName || ' ' || c.supplierName) " +
        "@@ to_tsquery('english', :filter)", nativeQuery = true)
List<Contacts> findByMultiKeywordFulltext(String filter);

调用时直接传入多关键词即可，PostgreSQL会自动将空格解析为AND逻辑（比如输入"Smith Foodmarket"会匹配同时包含Smith和Foodmarket的记录）。

注意事项 #

• 方法1的LIKE查询在数据量小时够用，但大数据量下性能有限，且%xxx%格式无法利用普通B树索引。
• 方法2的全文搜索支持更复杂的逻辑（比如用|表示OR、!表示NOT），可按需扩展。
• 预处理关键词时需过滤空字符串，Spring Data JPA的参数绑定已做SQL注入防护，无需额外处理。

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