使用Mongoose执行全文搜索报错：Missing expected field "$search"

问题背景 #

在mongosh中执行如下全文搜索查询可正常返回结果：

db.collection.find(
  {
    authorUid: 'X',
    '$text': { '$search': 'searchStr' }
  },
  { _id: 1, title: 1, src: 1 },
  { sort: { createdAt: -1 } }
)

但使用Mongoose的find方法执行相同逻辑的查询时，抛出错误：

MongoServerError: Missing expected field "$search"

即使硬编码查询条件（排除filterObj的问题），报错依然存在；改用aggregate的$match阶段执行相同查询则完全正常。

核心原因 #

1. Schema校验拦截：Mongoose默认会根据Schema定义校验查询条件，如果Schema中未正确配置全文索引对应的字段，Mongoose可能误判$text查询的结构，导致发送到MongoDB的请求丢失$search字段。
2. 版本兼容性问题：部分旧版Mongoose（如v6.x早期版本）对$text查询的语法解析存在bug，无法正确处理嵌套的$search结构。

解决方案 #

1. 确保Schema正确配置全文索引 #

在Mongoose Schema中明确为需要全文搜索的字段创建索引，示例：

const YourSchema = new mongoose.Schema({
  title: String,
  content: String, // 假设这是需要全文搜索的字段
  authorUid: String,
  createdAt: Date
});

// 创建包含目标字段的全文索引
YourSchema.index({ title: 'text', content: 'text' });

const Collection = mongoose.model('Collection', YourSchema);

注意：已存在的集合创建索引后，需等待索引构建完成再执行查询。

2. 用lean()跳过Mongoose文档校验 #

通过lean()方法让Mongoose直接返回普通JS对象，跳过Schema层面的查询校验，确保查询条件原封不动发送到MongoDB：

const result = await Collection.find(
  {
    authorUid: 'X',
    $text: { $search: 'searchStr' }
  },
  { _id: 1, title: 1, src: 1 }
)
.sort({ createdAt: -1 })
.lean();

3. 升级Mongoose到最新稳定版 #

若使用的是旧版Mongoose，升级到v7+或最新稳定版，可修复旧版本中存在的$text查询解析bug。

为什么Aggregate可以正常工作？ #

Mongoose的aggregate方法默认不对聚合阶段的查询做严格Schema校验，会直接将$match中的条件原封不动传递给MongoDB，因此不会出现字段丢失的问题。

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