pymongo使用$运算符更新MongoDB数组元素报错如何解决？

你编写的values.$.item定位语法本身符合MongoDB官方更新规范，触发报错通常由以下几个原因导致，对应解决方案如下：

常见错误排查 #

• 数据库实例引用错误
  pymongo的MongoClient实例不能直接调用集合，需要先指定操作的数据库，这是新手高频出错点：

  # 错误写法
  import pymongo
  client = pymongo.MongoClient("mongodb://连接串")
  client.any_collection.find_one_and_update(...) # 跳过了数据库选择步骤
  
  # 正确写法
  import pymongo
  client = pymongo.MongoClient("mongodb://连接串")
  db = client.你的实际数据库名 # 替换为你要操作的数据库名称
  db.any_collection.find_one_and_update(...)
  

• 查询条件未匹配到有效数组元素
  当传入的any_id对应文档不存在，或者该文档的values数组中没有item为b的元素时，$位置运算符无法定位到有效下标，会直接抛出异常。可以先执行查询确认匹配记录存在：

  exist_doc = db.any_collection.find_one({"_id": any_id, "values.item": "b"})
  print(exist_doc) # 确认输出不为None再执行更新操作
  

• 版本兼容问题
  过低的pymongo或者MongoDB服务端版本对$运算符的支持存在缺陷，可先升级pymongo到最新稳定版：

  pip install --upgrade pymongo
  

更稳定的替代写法 #

推荐使用MongoDB 3.6及以上版本支持的arrayFilters写法，数组元素匹配逻辑独立，兼容性和可读性更好：

db.any_collection.find_one_and_update(
    {"_id": any_id},
    {
        "$set": {
            "values.$[targetElem].item": "new_value"
        }
    },
    array_filters=[{"targetElem.item": "b"}]
)

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