解决 Mongoose 复制文档时 VersionError：理解与实践

本教程详细解析了在使用 mongoose 从一个集合复制文档到另一个集合时遇到的 `versionerror`。我们将探讨 mongoose 文档状态和版本控制机制，并提供多种专业且可靠的解决方案，包括使用 `toobject()`、`_doc` 属性，以及如何正确处理 `_id` 和 `__v` 字段，确保数据复制操作的顺畅执行。

理解 Mongoose 的 VersionError

在使用 Mongoose 进行数据操作时，VersionError 是一个常见的错误，尤其是在尝试复制文档到新集合时。这个错误通常发生在 Mongoose 文档的 save() 方法被调用时，它发现文档的 _id 和 __v (版本键) 与数据库中现有文档不匹配。Mongoose 默认实现了乐观锁（Optimistic Locking），通过 __v 字段来确保并发更新时数据的一致性。

当您从一个集合中查询到一个 Mongoose 文档对象 (sourceClass)，并尝试直接将其传递给另一个 Mongoose 模型的构造函数 (new TakenClassesModel(sourceClass))，然后调用 save() 时，Mongoose 可能会误认为您正在尝试更新一个现有文档，而不是创建一个新文档。这是因为 sourceClass 对象携带着 Mongoose 内部的状态信息，包括其 _id 和 __v 字段，这些字段在 save() 操作时会被 Mongoose 用来查找并更新目标集合中的匹配文档。然而，由于目标集合中并没有一个 _id 和 __v 都匹配的文档（因为这是一个新插入操作），Mongoose 就会抛出 VersionError。

错误信息通常会显示 No matching document found for id "..." version ... modifiedPaths "..."，明确指出 Mongoose 无法找到符合指定 _id 和 __v 的文档进行更新。

核心问题：Mongoose 文档实例与纯 JavaScript 对象

Mongoose 查询返回的是一个 Mongoose 文档实例，它不仅仅是数据，还包含了一系列方法（如 save(), remove(), populate() 等）和内部状态（如 isNew 标志、__v 字段的跟踪）。当我们希望将数据复制到另一个集合时，我们实际上只需要文档的纯数据部分，而不是其完整的 Mongoose 实例状态。直接传递 Mongoose 实例会导致 Mongoose 内部逻辑混淆，从而引发 VersionError。

解决此问题的关键在于，在创建新文档实例之前，将源 Mongoose 文档转换为一个纯 JavaScript 对象。这样，目标 Mongoose 模型就会将其视为一个全新的数据源，从而执行插入操作，而不是尝试更新。

推荐的解决方案

有几种方法可以将 Mongoose 文档转换为纯 JavaScript 对象，从而避免 VersionError。

1. 使用 toObject() 或 toJSON() 方法

Mongoose 文档提供了 toObject() 和 toJSON() 方法，可以将文档实例转换为一个纯粹的 JavaScript 对象。这是最推荐且最清晰的方法。

• toObject(): 返回一个原始的 JavaScript 对象，通常包含所有 Mongoose 字段。
• toJSON(): 类似于 toObject()，但会应用任何在 Schema 中定义的 toJSON 转换（例如，删除 __v 字段，格式化日期等）。

示例代码：

// 假设 ClassModel 和 TakenClassesModel 已经定义
// const ClassModel = mongoose.model('Class', classSchema);
// const TakenClassesModel = mongoose.model('TakenClass', takenClassSchema);

app.post("/addClass", async (req, res) => {
  const { subject_id } = req.body;

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

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

    // 2. 将 Mongoose 文档转换为纯 JavaScript 对象
    //    这将剥离 Mongoose 的内部状态和版本跟踪
    const classDataToCopy = sourceClass.toObject();

    // 3. 处理 _id 和 __v 字段
    //    如果希望新文档拥有一个新的 _id，则删除原始 _id
    //    delete classDataToCopy._id;
    //    通常建议删除 __v 字段，因为它与源文档的版本相关
    delete classDataToCopy.__v;

    // 4. 使用纯对象数据创建目标模型的新实例
    const newTakenClass = new TakenClassesModel(classDataToCopy);

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

    res.status(201).json({ message: "Class successfully copied.", newClass: newTakenClass });

  } catch (err) {
    console.error("Error copying class:", err);
    res.status(500).json({ message: "Failed to copy class.", error: err.message });
  }
});

2. 访问 _doc 属性

Mongoose 文档实例的 _doc 属性直接存储了文档的原始纯 JavaScript 数据。这是另一种获取纯对象的方法，通常更为简洁。

文心大模型

百度飞桨-文心大模型 ERNIE 3.0 文本理解与创作

56

查看详情

示例代码：

// ... (同上，查找 sourceClass)

// 将 Mongoose 文档的 _doc 属性作为数据源
const classDataToCopy = { ...sourceClass._doc }; // 使用扩展运算符进行浅拷贝，避免直接修改 _doc

// 处理 _id 和 __v 字段
// delete classDataToCopy._id;
delete classDataToCopy.__v;

const newTakenClass = new TakenClassesModel(classDataToCopy);
await newTakenClass.save();

// ... (同上，响应处理)

3. 手动构造纯 JavaScript 对象（用户原始解决方案的原理）

尽管不如 toObject() 或 _doc 简洁，但手动从源文档中挑选所需字段来构造一个纯 JavaScript 对象也是可行的，并且是用户原始解决方案的原理。这种方法在您只需要复制文档的特定子集字段时特别有用。

示例代码：

// ... (同上，查找 sourceClass)

// 手动构造一个包含所需字段的纯 JavaScript 对象
const classDataToCopy = {
  _id: sourceClass._id, // 如果需要保留原始 _id
  title: sourceClass.title,
  description: sourceClass.description,
  // ... 其他需要复制的字段
};

// 如果不希望保留原始 _id，可以在此处删除
// delete classDataToCopy._id;

const newTakenClass = new TakenClassesModel(classDataToCopy);
await newTakenClass.save();

// ... (同上，响应处理)

重要注意事项

1. _id 字段处理:

   • 保留 _id: 如果您希望复制的文档在目标集合中拥有与源文档相同的 _id，那么在将纯对象传递给 TakenClassesModel 构造函数时，请确保 _id 字段存在。Mongoose 会尝试使用这个 _id 插入新文档。如果目标集合中已存在相同 _id 的文档，这会导致 MongoServerError: E11000 duplicate key error。
   • 生成新的 _id: 如果您希望新文档在目标集合中拥有一个全新的 _id，那么在将 Mongoose 文档转换为纯 JavaScript 对象后，务必 delete classDataToCopy._id;。Mongoose 会在保存时自动生成一个新的 _id。

2. __v 字段处理:

   • 在复制文档时，源文档的 __v 字段通常与目标集合无关。为了避免潜在的版本冲突或不必要的字段，强烈建议在将文档数据传递给新模型之前，delete classDataToCopy.__v;。

3. Schema 差异:

   • 如果 ClassModel 和 TakenClassesModel 的 Schema 定义不同，Mongoose 在保存 newTakenClass 时会自动过滤掉 classDataToCopy 中不属于 TakenClassesModel Schema 的字段，并为缺失的字段应用默认值（如果定义了）。请确保目标 Schema 包含了所有您希望复制的关键字段。

4. 错误处理:

   • 在实际应用中，务必添加健壮的错误处理机制。捕获 try...catch 块中的错误，并根据错误类型返回适当的 HTTP 状态码和消息。

总结

当您需要在 Mongoose 中将一个集合的文档复制到另一个集合时，核心在于避免 Mongoose 内部状态的干扰。通过将源 Mongoose 文档转换为纯 JavaScript 对象（使用 toObject()、_doc 或手动构造），您可以确保 Mongoose 将操作视为一个全新的文档插入，从而有效避免 VersionError。同时，根据业务需求妥善处理 _id 和 __v 字段，是实现平滑数据复制的关键。

以上就是解决 Mongoose 复制文档时 VersionError：理解与实践的详细内容，更多请关注php中文网其它相关文章！