使用Mongoose时MongoDB的$text运算符文本搜索返回空数组如何解决？

问题原因及解决方法 #

• 多余await导致查询逻辑异常
  你用的of是await-to-js这类异常捕获工具的API，要求传入Promise实例，你代码中多写了一层await，相当于把已经执行完成的查询结果传给of，会导致逻辑异常，修正后的查询代码如下：

// 确认导入的是你定义的StudentModel，这里要和导出的模型名对应
const [result, err] = await of(
  StudentModel.find({
    $text: { $search: req.query.term },
  }).limit(10)
);

• 全文索引未在集合中实际生效
  Mongoose仅会在首次初始化模型、集合不存在时自动创建索引。如果是后期新增的text索引，不会自动同步到已有集合。你可以在MongoDB shell中执行以下命令确认索引是否存在：

db.students.getIndexes()

如果返回结果中没有name_text_code_text类型的索引，手动执行创建即可：

db.students.createIndex({ name: 'text', code: 'text' })

开发环境也可以在Mongoose连接配置中开启autoIndex: true，确保索引自动同步。

• 分词规则导致特殊字符关键词匹配失效
  MongoDB默认的英文分词器会将.等非字母数字字符作为分词分隔符，你的code: "a0.2"会被拆分为a0、2两个独立的词，搜索a0.2时也会被拆分。如果你需要将a0.2作为完整词组匹配，需要在搜索时给该部分包裹双引号：

// 搜索a0.2 ghi的场景，处理为如下格式
$text: { $search: '"a0.2" ghi' }

被双引号包裹的内容会被识别为完整词组，严格匹配。

• 确认参数传递正常
  打印req.query.term确认搜索关键词是否正确传递，有没有被编码转义导致符号丢失。

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