ArangoDB/AQL嵌套文档更新报错‘missing document key’原因咨询

嘿，我来给你掰扯清楚这个问题～

首先，ArangoDB的UPDATE（还有REPLACE这类写操作）有个硬性要求：你必须明确告诉它要更新哪篇文档。要么直接给出文档的_key值，要么用FILTER精准定位到目标文档。如果你的简洁查询里没做这件事，数据库就懵了——它不知道该把更新内容应用到集合里的哪条数据，自然就抛出"missing document key"这个错误了。

举个你可能写过的错误示例：

UPDATE {
  "embeddedArray[*].fieldToUpdate": "newValue"
} IN myCollection

你看，这个查询只说了要改哪个字段，但完全没说要改哪篇文档，ArangoDB当然会报错啦。

你找到的那个冗长方案，其实是把更新嵌入式数组的两个必要步骤都写全了：

• 先找到要改的文档：通过FILTER或者_key锁定目标
• 修改数组里的特定元素：用AQL的数组操作（比如遍历、替换）来精准更新数组里的某一项，而不是像普通字段那样直接赋值

给你整个简化版的正确写法，对应你说的更新嵌入式数组的场景：
假设你的文档长这样：

{
  "_key": "doc123",
  "embeddedArray": [
    {"id": 1, "name": "旧名字"},
    {"id": 2, "name": "另一个名字"}
  ]
}

要把embeddedArray里id=1的元素的name改成新值，正确的AQL应该是：

FOR doc IN myCollection
  FILTER doc._key == "doc123" // 这步必须有！锁定要改的文档
  UPDATE doc WITH {
    embeddedArray: (
      FOR item IN doc.embeddedArray
        RETURN item.id == 1 ? MERGE(item, {name: "新名字"}) : item
    )
  } IN myCollection

这里面，外层的FOR+FILTER负责找对文档，内层的遍历负责修改数组里的目标元素。

你的简洁写法直接跳过了定位目标文档的关键步骤，数据库找不到要更新的对象，所以报错。其实也有相对简洁的正确写法，只要你补上文档定位就行：
比如直接用_key定位的紧凑版：

UPDATE "doc123" WITH {
  embeddedArray: MAP(doc.embeddedArray, item => item.id == 1 ? MERGE(item, {name: "新名字"}) : item)
} IN myCollection

这个写法比你找到的冗长版本清爽，但依然保留了必须的文档定位和数组修改逻辑，就不会报错啦。

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