MongoDB按textScore排序报错：pipeline需文本分数元数据但不可用

我之前帮朋友排查过几乎一模一样的问题，咱们从核心原因到具体步骤一步步来解决：

核心原因 #

这个报错的本质是：你的查询没有触发文本搜索操作，所以MongoDB不会生成textScore元数据，排序时自然找不到这个字段。哪怕你已经建了文本索引，只要没执行$text查询，就不会产生text score。

具体排查与解决步骤 #

1. 确保查询包含$text文本搜索 #

不管你用普通Find操作还是Aggregation管道，必须先执行$text + $search的文本匹配操作，这是生成textScore的前提：

• 普通Find操作的正确写法：

// 构造文本查询条件
Bson textQuery = Filters.text("你要搜索的关键词");

• Aggregation管道的正确写法：

// 管道第一步必须是包含$text的$match阶段
Aggregation aggregation = Aggregation.newAggregation(
    Aggregation.match(Filters.text("你要搜索的关键词")),
    Aggregation.sort(Sorts.metaTextScore())
);

划重点：如果你的查询里完全没有$text相关操作，直接去排序$meta:"textScore"，肯定会抛出你遇到的错误。

2. 检查排序语法是否正确 #

在Java驱动中，按textScore排序必须使用专门的方法，不能直接把textScore当成普通字段排序：

• 错误示例（会报错）：

// 错误：直接引用textScore字段排序
collection.find(textQuery).sort(Sorts.descending("textScore"));

• 正确示例：

// 正确：使用metaTextScore方法排序
collection.find(textQuery)
    .sort(Sorts.metaTextScore()); // 默认降序，也可以指定字段名投影后排序

// 如果需要把textScore显示在结果里，加上投影操作
collection.find(textQuery)
    .projection(Projections.metaTextScore("matchScore")) // 将textScore投影为matchScore字段
    .sort(Sorts.metaTextScore("matchScore"));

3. 验证文本索引是否符合要求 #

虽然你提到已经创建了文本索引，但还是可以再确认下细节：

• 打开MongoDB Shell，执行db.yourCollectionName.getIndexes()
• 查看返回结果中是否有类型为text的索引，且包含你要搜索的目标字段。正常的文本索引应该类似：

{
  "v" : 2,
  "key" : { "_fts" : "text", "_ftsx" : 1 },
  "name" : "targetField_text",
  "ns" : "yourDatabase.yourCollectionName",
  "weights" : { "targetField" : 1 },
  "default_language" : "english",
  "textIndexVersion" : 3
}

4. 聚合管道中不能跳过$match阶段 #

如果用Aggregation做文本搜索，一定要把包含$text的$match放在管道的最开头，不能先执行分组、投影等操作再做文本匹配，否则也会导致textScore元数据无法生成。

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