如何基于Spring Data SolrCrudRepository实现Solr布尔检索

核心问题根因 #

Spring Data Solr 的派生方法仓储实现，默认会将入参作为纯字面量文本做转义后，拼接到对应字段的查询表达式中。这种设计是为了避免用户输入的内容意外触发Solr查询语法逻辑、防范查询注入，但也导致传入的AND/OR等布尔运算符会被当成待匹配的普通文本的一部分，无法生成预期的布尔检索逻辑。

无需硬编码原生查询的实现路径 #

1. 直接用@Query注解定义带占位符的布尔查询 #

这是成本最低的开箱即用方案，完全绕开方法名派生的参数绑定逻辑：

public interface SolrDocRepository extends SolrCrudRepository<SolrDoc, String> {
    // 同字段多值OR查询示例
    @Query("title:?0 OR title:?1")
    Page<SolrDoc> searchTitleWithOr(String termA, String termB, Pageable pageable);

    // 跨字段布尔组合查询示例
    @Query("(title:?0 OR subject:?1) AND type:?2")
    Page<SolrDoc> searchMultiField(String titleTerm, String subjectTerm, String typeTerm, Pageable pageable);
}

这种方式下Spring Data会自动对占位符绑定的参数做安全转义，最终生成的查询会和预期的q=title:train OR title:locomotive格式完全一致，不会把布尔运算符当成普通文本。

2. 基于Criteria API构建动态布尔检索 #

如果需要根据传入的参数动态拼接布尔逻辑，不需要自己写字符串解析，直接使用Spring Data Solr自带的Criteria工具类即可：

• 首先在仓储层定义自定义扩展接口：

interface SolrDocRepositoryCustom {
    Page<SolrDoc> searchFieldWithOrTerms(String fieldName, List<String> terms, Pageable pageable);
}

• 编写扩展实现类：

public class SolrDocRepositoryImpl implements SolrDocRepositoryCustom {
    @Autowired
    private SolrTemplate solrTemplate;
    private static final String DEFAULT_CORE = "你的Solr核心名";

    @Override
    public Page<SolrDoc> searchFieldWithOrTerms(String fieldName, List<String> terms, Pageable pageable) {
        // 自动拼接同字段多值OR逻辑
        Criteria fieldCriteria = new Criteria(fieldName);
        terms.forEach(term -> fieldCriteria = fieldCriteria.or(term));
        Query query = new SimpleQuery(fieldCriteria).setPageRequest(pageable);
        return solrTemplate.queryForPage(DEFAULT_CORE, query, SolrDoc.class);
    }
}

• 让原仓储接口继承自定义扩展接口即可直接调用方法，不需要手动拼接Solr查询字符串，也不用担心特殊字符转义问题。

自由输入带布尔运算符的处理方式 #

如果业务场景是直接接收用户输入的包含AND/OR的自由检索文本，就不能依赖上面的参数绑定逻辑了：

• 自行拆分输入文本的词元、识别布尔运算符的逻辑，手动拼接成符合字段匹配要求的查询串
• 拼接完成后通过SolrTemplate直接执行查询即可
• 需要做好特殊字符的过滤和转义，避免恶意输入触发非预期的查询逻辑

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