Mongoose使用$push更新文档push_subscriptions数组无效
故障原因定位与修复方案
核心问题排查方向
按照出现概率从高到低排序:
- Mongoose Schema 宽泛类型定义导致更新被静默拦截
当前将push_subscriptions定义为无结构约束的type: Array,在Mongoose严格模式下,对嵌套了自定义对象的数组执行$push操作时,会因为没有匹配明确的元素结构校验规则,直接静默丢弃整个写入操作,仅触发时间戳字段的自动更新。
修复时需要把数组定义替换为匹配存储结构的强类型定义:push_subscriptions: { type: [{ endpoint: String, keys: { p256dh: String, auth: String } }], default: [] } - 查询参数缺失导致校验规则异常拦截
执行findByIdAndUpdate时默认不会运行字段校验,也不会放开非严格匹配的写入。可以临时在更新配置中加入两个参数定位问题:
如果配置后数组可以正常写入,就说明之前的拦截来自Mongoose的严格模式规则,回到上一步补全Schema字段结构即可。const updated_user = await UserModel.findByIdAndUpdate( user_id, { $push: { push_subscriptions: subscription } }, { new: true, runValidators: true, // 开启更新时的字段校验 strict: false // 临时关闭严格模式,允许写入未在Schema中定义的结构 } ).exec(); - 入参结构异常导致写入失败
如果传入的subscription对象存在未定义的嵌套字段、值为undefined的属性,Mongoose会直接丢弃整个$push操作。更新前需要对入参做一次结构清洗,只保留需要存储的字段,剔除多余属性:
将清洗后的const cleanSubscription = { endpoint: subscription.endpoint, keys: { p256dh: subscription.keys?.p256dh, auth: subscription.keys?.auth } }cleanSubscription传入$push操作即可避免因结构异常导致的写入失败。
快速验证技巧
如果需要快速判断问题出在MongoDB层还是应用代码层,可以直接在MongoDB shell中执行相同的$push更新语句:
- 如果shell中执行后数组可以正常写入,说明问题100%出在Mongoose的Schema校验拦截,和MongoDB本身的逻辑无关。
- 如果shell中执行后数组也无法更新,需要检查对应文档的权限配置、是否存在文档版本冲突拦截。
内容的提问来源于stack exchange,提问作者Mike Ehrmantraut
相关产品推荐
相关产品推荐

