MongoDB/Mongoose中嵌套数组$set使用$[<identifier>]操作符失效问题排查

看起来你踩了MongoDB arrayFilters的一个常见坑——你的过滤条件和数组子文档的结构不匹配，导致根本找不到要更新的元素，所以nModified一直是0。我来帮你拆解问题，再给出解决办法：

先解释你遇到的几个现象的原因 #

• 为什么arrayFilters: [{ "index": 0 }]没用？
  你写的这个过滤条件是在找stores数组中包含index字段且值为0的子文档，但你的stores子文档根本没有index字段（看你的Schema和示例文档就能确认），所以MongoDB找不到任何符合条件的元素，自然不会执行更新，nModified就是0。

• 为什么同时用$[]和arrayFilters会报错？
  $[]是更新数组所有元素的通配符，而你在arrayFilters里定义了index这个标识符，但更新语句里根本没用到它（你用的是$[]而不是$[index]），MongoDB会严格检查这种“定义了过滤条件但未使用”的情况，所以直接报错。

• 为什么改成{"index":1}会触发CastError？
  你的Product Schema里的stores子文档没有index字段，当你尝试用{"index":1}作为过滤条件时，Mongoose会尝试把值1存入不存在的stores.index路径，这就触发了类型转换失败的错误。

解决方案 #

方案1：直接用数字索引更新（最简单，适合已知元素位置的情况）

如果你明确知道要更新stores数组的第1个元素（索引为0），直接用数字索引就能搞定，根本不需要arrayFilters：

await Product.update(
  { productName: product.productName },
  { "$set": { "stores.0.trackingUrl": 'url' } }
).then((item) => { console.log("Updated", item.nModified); });

方案2：正确使用arrayFilters（适合按子文档属性匹配的场景）

如果你需要更灵活的匹配逻辑（比如根据子文档的name、programId等字段找到要更新的元素），就要正确设置标识符和过滤条件：
比如要更新programId为0的stores元素：

await Product.update(
  { productName: product.productName },
  { "$set": { "stores.$[store].trackingUrl": 'url' } },
  { "arrayFilters": [ { "store.programId": 0 } ] }
).then((item) => { console.log("Updated", item.nModified); });

这里的store是我们自定义的标识符，arrayFilters里的store.programId: 0表示匹配stores数组中programId等于0的子文档，然后更新该元素的trackingUrl。

补充注意点 #

确保你的MongoDB服务器版本在3.6及以上（arrayFilters是3.6版本引入的），不过现在大部分开发环境都满足这个要求。

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