Mongoose 数据复制 VersionError 深度解析与解决方案

本文深入探讨了在 mongoose 中将文档从一个集合复制到另一个集合时可能遇到的 `versionerror`。我们将解析该错误产生的根本原因，即 mongoose 对文档实例和版本控制的内部处理机制。文章将提供安全且推荐的解决方案，通过将 mongoose 文档转换为普通 javascript 对象来确保正确的数据复制，并详细讨论 `_id` 和 `__v` 字段的处理策略，以避免潜在的错误并实现高效的数据迁移。

Mongoose 文档复制中的 VersionError 概述

在使用 Mongoose 进行开发时，将一个集合中的文档数据复制到另一个集合是常见的操作。然而，直接将从数据库查询到的 Mongoose 文档实例传递给另一个 Mongoose 模型的构造函数并尝试保存时，可能会遇到 VersionError，错误信息通常为 No matching document found for id "..." version 0 modifiedPaths "..."。

这个错误表明 Mongoose 在尝试保存文档时，发现其内部版本号（__v 字段）与数据库中的版本号不匹配，或者 Mongoose 误以为正在尝试更新一个不存在的文档。这通常是 Mongoose 的乐观并发控制机制在起作用。

理解 Mongoose 的乐观并发控制与 __v 字段

Mongoose 使用 __v（版本密钥）字段来实现乐观并发控制。当一个文档被创建或更新时，Mongoose 会自动递增其 __v 字段。在执行更新操作时，Mongoose 会检查文档的当前 __v 值是否与数据库中的值匹配。如果不匹配，则意味着文档在当前操作开始后已被其他进程修改，从而抛出 VersionError，以防止数据冲突和覆盖。

在文档复制场景中，VersionError 的产生并非因为真正的并发修改，而是 Mongoose 内部状态处理上的误解。

VersionError 的根本原因

当您从 ClassModel 查询到一个 Mongoose 文档实例 classTaken，然后尝试将其直接传递给 TakenClassesModel 的构造函数：

const newClass = TakenClassesModel(classTaken);
await newClass.save();

classTaken 此时是一个完整的 Mongoose 文档实例，它包含了 Mongoose 内部状态信息，如 isNew 标志、__v 版本字段以及其原始集合的 _id。当这个 Mongoose 实例被传递给 TakenClassesModel 的构造函数时，Mongoose 可能会混淆其内部状态。它可能错误地将 newClass 实例识别为正在尝试更新一个现有文档（因为 classTaken 已经是一个“已存在”的文档实例），而不是创建一个全新的文档。

在这种情况下，newClass.save() 操作可能不会被视为一个插入操作，而是被 Mongoose 内部逻辑处理为一个更新操作。由于 TakenClassesModel 集合中尚不存在与 classTaken._id 匹配的文档，并且 __v 字段也被带入，Mongoose 尝试更新时找不到匹配的文档，便会抛出 VersionError。

解决方案：转换为普通 JavaScript 对象

解决 VersionError 的关键在于确保 Mongoose 在创建新文档时，接收的是一个纯粹的 JavaScript 对象，而不是一个带有 Mongoose 内部状态的文档实例。这样，Mongoose 会明确地将其视为一个新文档的插入请求。

百度虚拟主播

百度智能云平台的一站式、灵活化的虚拟主播直播解决方案

36

查看详情

Mongoose 文档实例提供了两种主要方法来获取其普通 JavaScript 对象表示：

1. .toObject() 方法：这是推荐的方法，它返回一个文档的普通 JavaScript 对象表示。此方法还可以接受选项来自定义输出（例如，是否包含虚拟属性、getter 等）。
2. ._doc 属性：Mongoose 文档实例的 _doc 属性直接引用了存储文档数据的底层普通 JavaScript 对象。

通过这两种方法，我们可以剥离 Mongoose 实例的内部状态，只保留纯粹的数据。

关键考量：_id 和 __v 字段的处理

在将 Mongoose 文档转换为普通 JavaScript 对象后，我们还需要决定如何处理 _id 和 __v 字段：

1. __v 字段：当复制数据到新文档时，总是应该删除 __v 字段。新文档应该由 Mongoose 自动生成其初始版本号。
2. _id 字段：
   • 生成新的 _id (推荐)：如果您的目标是创建一个完全独立的副本，通常希望新文档拥有一个全新的 _id。在这种情况下，也应该删除 _id 字段，让 Mongoose 自动生成一个新的 _id。
   • 保留原始 _id：如果出于特定业务需求，新文档需要与原始文档拥有相同的 _id，那么在转换为普通对象后，您可以保留 _id 字段。但请注意，这要求目标集合中不能存在具有相同 _id 的文档，否则 save() 操作将抛出 E11000 duplicate key error。

示例代码：生成新的 _id

这是最常见的复制场景，创建的副本与原文档在 _id 上是独立的。

// POST request to add a class taken
app.post("/addClass", async (req, res) => {
  const subject_id = req.body.subject_id;

  try {
    // 1. 从源集合查找文档
    const classToCopy = await ClassModel.findOne({ subject_id: subject_id });

    if (!classToCopy) {
      return res.status(404).json({ message: "Class not found." });
    }

    // 2. 将 Mongoose 文档转换为普通 JavaScript 对象
    const plainObject = classToCopy.toObject();

    // 3. 删除 _id 和 __v 字段，让 Mongoose 为新文档生成新的值
    delete plainObject._id;
    delete plainObject.__v;

    // 4. 使用普通对象创建新的 Mongoose 文档实例
    const newClassInstance = new TakenClassesModel(plainObject);

    // 5. 保存新文档到目标集合
    await newClassInstance.save();

    res.status(201).json(newClassInstance); // 返回新创建的文档
  } catch (err) {
    console.error("Error copying class:", err);
    res.status(500).json({ message: "Failed to copy class.", error: err.message });
  }
});

示例代码：保留原始 _id

如果您的业务逻辑要求复制的文档保持与原始文档相同的 _id，请使用以下方法。请务必处理潜在的 E11000 错误。

// POST request to add a class taken
app.post("/addClass", async (req, res) => {
  const subject_id = req.body.subject_id;

  try {
    const classToCopy = await ClassModel.findOne({ subject_id: subject_id });

    if (!classToCopy) {
      return res.status(404).json({ message: "Class not found." });
    }

    const plainObject = classToCopy.toObject();

    // 只删除 __v 字段，保留 _id
    delete plainObject.__v;

    const newClassInstance = new TakenClassesModel(plainObject);
    await newClassInstance.save();

    res.status(201).json(newClassInstance);
  } catch (err) {
    console.error("Error copying class (preserving _id):", err);
    // 处理 _id 重复键错误
    if (err.code === 11000) {
      return res.status(409).json({ message: "A class with this ID already exists in TakenClasses.", error: err.message });
    }
    res.status(500).json({ message: "Failed to copy class.", error: err.message });
  }
});

注意事项

• 数据量与性能：上述方法适用于复制单个或少量文档。如果需要批量复制大量文档，直接在应用层循环操作可能会导致性能问题。
• MongoDB 原生操作：对于大规模数据迁移或复制，考虑使用 MongoDB 的聚合管道操作，例如 $out 或 $merge 阶段，它们可以在数据库服务器端高效地完成数据复制，而无需将数据传输到应用层。

  // 示例：使用聚合管道在 MongoDB 中复制数据
  // 这需要在 MongoDB 驱动层面或通过 Mongoose 的 Model.aggregate() 调用
  ClassModel.aggregate([
    { $match: { subject_id: "some_id" } }, // 筛选要复制的文档
    { $project: { _id: 0, __v: 0, ...other_fields_to_include } }, // 投影并删除不需要的字段
    { $merge: { into: "takenclasses", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
    // 或者使用 $out: "takenclasses" 如果目标集合不存在或可以完全覆盖
  ]).exec();

  登录后复制
• 错误处理：在实际应用中，务必对 save() 操作进行健壮的错误处理，特别是当选择保留 _id 时，需要捕获并处理 E11000 duplicate key error。

总结

在 Mongoose 中从一个集合复制数据到另一个集合时，遇到 VersionError 通常是由于直接传递 Mongoose 文档实例而非纯 JavaScript 对象所致。通过将源文档转换为普通 JavaScript 对象，并根据需求正确处理 _id 和 __v 字段，可以有效避免此错误。对于大规模数据复制，建议考虑利用 MongoDB 原生操作以提高效率。遵循这些最佳实践，可以确保数据复制过程的顺畅和可靠。

以上就是Mongoose 数据复制 VersionError 深度解析与解决方案的详细内容，更多请关注php中文网其它相关文章！