$[]不能直接加条件，因其仅为无条件全量遍历占位符；必须使用$[identifier]配合arrayfilters，且标识符名须严格一致、大小写敏感，仅支持单层数组过滤。
![如何在mongodb中更新数组中所有匹配条件的项_利用$[identifier]语法](https://img.php.cn/upload/article/000/969/633/177949378862418.jpg?x-oss-process=image/resize,p_40)
为什么 $[] 不能直接加条件？
很多人写 db.collection.updateOne({ _id: 1 }, { $set: { "items.$[].price": 99 } }) 能成功，但一加条件就报错或不生效——因为 $[] 是“无条件全量数组遍历”，它本身不支持内嵌查询。MongoDB 不允许你在 $[] 后面直接跟 $elemMatch 或字段比较，比如 "items.$[item].price" 中的 item 必须先在 arrayFilters 里声明并定义条件。
必须配对使用 $[identifier] 和 arrayFilters
真正起作用的是带标识符的 $[identifier]，不是裸 $[]。它本质是个占位符，行为完全依赖 arrayFilters 数组里的规则：
-
arrayFilters中每个对象必须以identifier开头，例如{ "item.status": "pending" }对应$[item] - 标识符名（如
item）在update和arrayFilters中必须完全一致，大小写敏感 - 一个
$[item]只能匹配数组中满足对应 filter 的元素，不匹配的跳过 - 不支持嵌套多层 identifier（如
$[item].tags.$[tag]），MongoDB 目前只允许一层数组过滤
示例：把所有 status: "draft" 的子文档的 published 设为 false
db.posts.updateMany(
{ "comments.author": "alice" },
{ $set: { "comments.$[c].published": false } },
{ arrayFilters: [ { "c.status": "draft" } ] }
)
常见错误现象和绕过方式
典型报错：PlanExecutor error during aggregation :: caused by :: The positional operator '[]' is not allowed in this context，基本是因为写了 $[].field 却没用 arrayFilters，或 identifier 名不匹配。
- 写成
"items.$[].status"→ 报错；必须改用"items.$[i].status"+arrayFilters: [{ "i.status": { $exists: true } }] - filter 写成
{ "item.name": "a" }，但 update 里写"arr.$[x].val"→ 不生效，identifier 名不一致 - 想更新嵌套数组（如
orders.items）中的items，但arrayFilters只能作用于最外层数组字段，需用聚合管道更新（updateMany+$setwith$map）
性能与兼容性注意点
$[identifier] 在 3.6+ 生效，4.2+ 支持更灵活的表达式（如 $gt、$in），但仍有硬限制：
- 每个
arrayFilters条件只能引用一个数组字段，不能跨字段关联（如"c.created" > "c.updated"不合法） - 大量匹配时，
$[i]仍会扫描整个数组，不走索引；若需高频条件更新，建议把数组拆成独立集合 - 事务中使用
arrayFilters没问题，但 filter 表达式不能含读操作（如$expr引用其他字段值）
真正容易被忽略的是：identifier 不是变量，它不捕获值，只做条件绑定；你不能用它做计算或拼接字段名。
