如何预防Mongoose版本错误及文档并发更新覆盖问题？

• 锁定依赖版本：在package.json中指定Mongoose的精确版本（不要用^或~前缀），比如"mongoose": "7.6.3"，避免npm自动升级引发兼容性问题。
• 匹配Node.js版本：Mongoose不同版本对Node.js有明确要求，比如Mongoose 7.x需要Node.js 14.20+，用nvm等工具管理Node版本，确保二者兼容。
• 升级前做兼容性测试：在测试环境先升级Mongoose，跑全量业务测试，重点校验Schema定义、查询/更新逻辑、中间件（钩子）的执行是否正常。
• 关注官方变更日志：升级前仔细阅读Mongoose的Release Notes，重点留意Breaking Changes部分，比如API废弃、Schema规则调整等内容。
• 避免多版本混用：确保项目依赖中只有一个Mongoose版本，多版本共存会导致ODM实例冲突、Schema解析异常等问题。

你的代码出现并发覆盖的核心原因是：先查询文档到内存修改，再保存回数据库，这个过程是非原子的，并发请求会基于旧的文档快照修改，后保存的会覆盖先保存的修改。以下是几种可行的解决方法：

1. 使用原子更新操作（推荐） #

直接通过MongoDB的原子操作符在数据库层面完成修改，避免先查后改的非原子流程。针对你的代码，可以用updateOne结合$push操作：

exports.readInfo = async (req, res, n) => {
  const user = req.user;
  const data = req.data;
  // 直接在数据库层面执行原子push操作
  const result = await Doc.updateOne(
    { _id: new ObjectId(data._id) },
    { $push: { [`infos.${data.key}.${data.skey}.${data.i}.read`]: user._id.toString() } }
  );
  return res.end("success");
};

这种方式由MongoDB保证操作的原子性，多个并发请求的修改会依次生效，不会出现覆盖。

2. 启用版本控制（乐观锁） #

Mongoose默认自带__v版本字段，开启后保存文档时会自动校验版本号，当当前文档的版本与数据库中的版本不匹配时，会抛出VersionError。此时可以捕获错误并重试操作：

exports.readInfo = async (req, res, n) => {
  const user = req.user;
  const data = req.data;
  const updatePath = `infos.${data.key}.${data.skey}.${data.i}.read`;
  
  let retries = 3; // 设置重试次数
  while (retries > 0) {
    try {
      const doc = await Doc.findOne({ _id: new ObjectId(data._id) });
      doc[updatePath].push(user._id.toString());
      doc.markModified(updatePath);
      await doc.save();
      return res.end("success");
    } catch (err) {
      if (err.name === 'VersionError' && retries > 0) {
        retries--;
        continue; // 版本冲突，重试
      }
      throw err; // 其他错误抛出
    }
  }
  return res.end("failed: retries exhausted");
};

这种方式适合无法用原子操作符完成复杂修改的场景，通过重试机制处理并发冲突。

3. 使用MongoDB事务（适用于复杂多文档操作） #

如果业务涉及多个文档的修改，可以使用MongoDB事务（需要部署副本集），事务会保证一组操作的原子性，要么全部成功要么全部回滚。但对于单文档修改，原子操作或版本控制已经足够，事务会带来额外性能开销。

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