PyMongo中find_one_and_update结合文本搜索与排序的报错问题

兄弟，你遇到的这个报错完全是因为参数顺序不对导致的！咱们来拆解一下问题：

find_one_and_update的参数结构是这样的：

db.collection.find_one_and_update(
    filter,       # 查询条件
    update,       # 更新操作（必须全是$开头的操作符，比如$set）
    options       # 可选配置：投影、排序、返回设置等
)

你原来的代码里，把投影字段{"score": {"$meta": "textScore"}}直接和$set放在了第二个参数（更新操作）里，这就触发了ValueError——因为更新操作只能包含$set、$inc这类以$开头的操作符，不能直接放普通字段。

正确的写法应该是这样： #

from pymongo import ReturnDocument  # 如果需要返回更新后的文档，记得导入这个

db.stores.find_one_and_update(
    # 第一个参数：查询条件（文本搜索）
    {"$text": {"$search": search_string}},
    # 第二个参数：更新操作，只有$set
    {"$set": store_attributes},
    # 第三个参数：可选配置，把投影和排序放在这里
    {
        "projection": {"score": {"$meta": "textScore"}},
        "sort": [("score", {"$meta": "textScore"})],
        # 可选：如果想返回更新后的文档，加上这个
        "return_document": ReturnDocument.AFTER
    }
)

关键说明： #

• projection选项用来指定要返回的字段，这里把文本匹配的score加进去，同时和sort配合，确保先按文本匹配度排序，再更新最匹配的那一条。
• 如果你不需要返回score字段，只需要排序的话，甚至可以去掉projection，只保留sort配置就行——排序本身不需要投影字段存在，MongoDB内部会用textScore来排序。

这样写就完全符合MongoDB的API规范，不会再报错啦，而且直接实现了“按文本搜索排序后更新第一条匹配文档”的需求，比用find().limit(1)再手动更新要简洁得多。

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