升级依赖后Mongoose文本索引查询报错：无法满足$text查询

可能的原因分析 #

• 索引实际状态与定义不符：虽然Mongoose代码里定义的是仅包含文本键的索引，但升级依赖后，可能存在旧索引未被正确清理，或者Mongoose创建索引时出现异常，导致数据库中实际存在包含非文本前置键的复合文本索引。
• 多文本索引冲突：如果对应集合中存在多个文本索引，MongoDB查询优化器在选择索引时可能出现逻辑错误，触发类似复合索引的报错提示。
• 查询条件写法影响索引判断：查询中使用的.where('isDeleted').ne(true)链式条件，在新版本驱动或MongoDB中，可能让查询优化器尝试结合非文本索引字段，导致对索引使用的判断出现偏差。

具体排查与解决步骤 #

1. 检查数据库实际索引结构
   连接MongoDB，针对目标集合执行以下命令，查看索引的真实结构：

   db.你的集合名称.getIndexes() // 替换为实际集合名，比如recipeBases、recipeUsers等
   

   确认是否存在包含非文本前置键的复合文本索引，或者多个冗余的文本索引。若存在异常索引，直接删除后重新创建。

2. 强制同步Mongoose索引
   升级依赖后可能存在索引未同步的情况，可在应用启动时强制同步索引（生产环境需谨慎操作，避免锁表）：

   // 在模型加载完成后执行
   RecipeBaseSchema.syncIndexes();
   RecipeUserSchema.syncIndexes();
   RecipeAdminSchema.syncIndexes();
   

   也可以手动删除旧索引，让Mongoose重新创建符合代码定义的索引。

3. 调整查询条件写法
   将isDeleted的条件合并到查询对象中，替代链式.where方法，尝试修正优化器的索引判断逻辑：

   const query = {
     $text: { $search: req.params.search },
     isDeleted: { $ne: true }
   };
   
   const recipes = await model
     .find(query, { score: { $meta: 'textScore' } })
     .sort({ score: { $meta: 'textScore' } })
     .limit(parseInt(req.query.limit, 10) || 100)
     .skip(parseInt(req.query.skip, 10) || 0)
     .populate(populate);
   

4. 核对依赖版本变更
   对比升级前后的mongoose和mongodb驱动版本，查看官方更新日志，确认是否有文本索引、查询优化器相关的逻辑变更，比如部分版本对文本索引的匹配规则做了调整。

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