MongoDB更新报错ambiguous positional update operation的原因与解决

问题场景 #

你在MongoDB v3.6.3中有这样的集合文档：

{ _id: '1', elements:[ { _id: '11', status: 'DRAFT' }, { _id: '12', status: 'DRAFT' } ] }

尝试执行以下update语句，想仅当_id为11的子元素状态是DRAFT时，将其更新为APPROVED：

db.getCollection('jobs').update( {'_id':'1', 'elements._id': '11', 'elements.status': 'DRAFT'}, {'$set': { 'elements.$.status' : 'APPROVED' } } )

却收到报错：

ambiguous positional update operation

报错原因 #

这个报错的核心是位置操作符$的匹配歧义：
当你在查询条件中同时写elements._id: '11'和elements.status: 'DRAFT'时，MongoDB的查询逻辑是“文档里存在至少一个_id为11的数组元素，并且存在至少一个status为DRAFT的数组元素”——这两个条件可能匹配数组里的不同元素。但update操作中的$需要明确指向同一个要更新的数组元素，此时MongoDB无法确定$该指向哪个元素，因此抛出歧义错误。

而你提到的find语句能正常执行，是因为find只需要验证文档是否满足“存在这两类元素”的条件，不需要确认这两个条件是否对应同一个元素，所以不会有歧义问题：

db.getCollection('jobs').find({ '_id':'1', 'elements._id': '11', 'elements.status': 'DRAFT'})

解决方案 #

要解决这个问题，需要用$elemMatch操作符强制约束同一个数组元素同时满足_id: '11'和status: 'DRAFT'两个条件，这样位置操作符$就能精准定位到要修改的元素，不会产生歧义：

db.getCollection('jobs').update(
  { 
    '_id':'1', 
    'elements': { 
      '$elemMatch': { '_id': '11', 'status': 'DRAFT' } 
    } 
  }, 
  {'$set': { 'elements.$.status' : 'APPROVED' } }
)

简单来说，$elemMatch就是告诉MongoDB：“我要找的是数组里同时符合这两个条件的同一个元素，不是分别符合条件的不同元素”，这样update时就能准确找到目标元素进行修改了。

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