Spring Boot MongoTemplate聚合查询问题：仅title匹配有结果，description匹配无结果

常见问题排查点 #

1. $match阶段漏加description的匹配逻辑 #

这是最容易踩的坑——你可能在聚合的匹配阶段只针对title字段做了文本匹配，完全没把description纳入$or的判断范围。比如错误代码是这样的：

// 只查title里的文本，description完全没参与匹配
Aggregation.match(Criteria.where("eventId").is(eventId)
                          .and("title").regex(searchText, "i"));

修正后要把两个字段用$or关联起来：

// 同时匹配title或description里的文本
Criteria textCriteria = new Criteria().orOperator(
    Criteria.where("title").regex(searchText, "i"),
    Criteria.where("description").regex(searchText, "i")
);
Aggregation.match(Criteria.where("eventId").is(eventId).andOperator(textCriteria));

2. 用$text文本查询时，description没加入文本索引 #

如果你的查询依赖MongoDB的文本索引（用$text + $search），那必须确保title和description都被包含在同一个文本索引里。要是你只给title建了文本索引：

// 错误：只有title能被文本搜索匹配
db.events.createIndex({ title: "text" })

那$search只会扫描title字段，自然找不到description里的内容。得把description也加进索引：

db.events.createIndex({ title: "text", description: "text" })

对应的Java代码里的匹配条件要改成：

Aggregation.match(Criteria.where("eventId").is(eventId)
                          .and("$text").is(searchText));

3. 聚合管道阶段顺序搞反了 #

要是你先做了$project操作，并且把description字段排除在外，那后续的$match阶段根本看不到description的值，自然匹配失败。比如：

// 先投影只保留eventId和title，之后的匹配逻辑找不到description
Aggregation.project("eventId", "title");

解决方法很简单：要么把$match阶段放在$project前面，要么在$project里把description也保留下来。

4. 正则表达式的匹配规则有问题 #

如果你的正则没加忽略大小写的选项，或者没转义特殊字符，也会导致description匹配失败。比如：

// 错误：大小写敏感，description里的"Pandemic"会匹配不到"pandemic"
Criteria.where("description").regex(searchText);
// 正确：加"i"忽略大小写
Criteria.where("description").regex(searchText, "i");

另外，如果搜索文本里包含.、*、+这类正则特殊字符，得先转义，不然会导致匹配逻辑混乱：

String escapedSearchText = Pattern.quote(searchText);
Criteria.where("description").regex(escapedSearchText, "i");

完整修正代码示例 #

下面是一个能正确匹配eventId，同时在title/description里搜索文本的聚合查询实现：

import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.aggregation.Aggregation;
import org.springframework.data.mongodb.core.aggregation.AggregationResults;
import org.springframework.data.mongodb.core.query.Criteria;
import java.util.regex.Pattern;

public List<Event> searchEvents(String eventId, String searchText) {
    // 转义正则特殊字符，避免匹配异常
    String escapedText = Pattern.quote(searchText);
    
    // 构建文本匹配条件：title或description包含指定文本
    Criteria textMatch = new Criteria().orOperator(
        Criteria.where("title").regex(escapedText, "i"),
        Criteria.where("description").regex(escapedText, "i")
    );
    
    // 构建聚合管道：先匹配eventId和文本条件
    Aggregation aggregation = Aggregation.newAggregation(
        Aggregation.match(Criteria.where("eventId").is(eventId).andOperator(textMatch))
        // 这里可以加其他聚合阶段，比如投影、排序、分页等
    );
    
    AggregationResults<Event> results = mongoTemplate.aggregate(aggregation, "events", Event.class);
    return results.getMappedResults();
}

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