pymongo调用MongoDB全文检索出现$search类型错误怎么解决？

错误根因 #

你混用了MongoDB两种不兼容的全文检索语法：

• 传统$text查询的参数结构为{"$text": {"$search": "检索字符串"}}，其中$search要求传入纯字符串，你将$search的配置对象嵌套到$text中，触发类型不匹配报错。
• $search是MongoDB Atlas Search专用的聚合阶段参数，不能作为$text的子字段使用。

解决方案 #

根据你使用的检索类型二选一即可：

方案1：使用传统$text全文检索

适用于所有MongoDB部署环境，前提是已经给对应集合创建了传统文本索引，修改代码如下：

# 已提前创建文本索引：db.collection.create_index([("要检索的字段名", "text")])
result = db.collection.find({
    "$text": {
        "$search": "paper"
    }
})

方案2：使用Atlas Search的$search检索

仅适用于MongoDB Atlas部署环境，前提是已经在Atlas控制台创建了名为title的搜索索引，使用聚合查询实现：

pipeline = [
    {
        "$search": {
            "index": "title",
            "text": {
                "query": "paper",
                "path": "要检索的字段名" # 如检索title字段则填"title"
            }
        }
    }
]
result = db.collection.aggregate(pipeline)

补充说明 #

• 传统$text检索仅支持整词匹配，不支持模糊匹配、自定义权重排序等高级功能
• Atlas Search的$search功能更丰富，支持分词、模糊匹配、自定义打分规则等复杂检索需求

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