本文深入探讨了在 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 会明确地将其视为一个新文档的插入请求。
云点滴客户解决方案是针对中小企业量身制定的具有简单易用、功能强大、永久免费使用、终身升级维护的智能化客户解决方案。依托功能强大、安全稳定的阿里云平 台，性价比高、扩展性好、安全性高、稳定性好。高内聚低耦合的模块化设计，使得每个模块最大限度的满足需求，相关模块的组合能满足用户的一系列要求。简单 易用的云备份使得用户随时随地简单、安全、可靠的备份客户信息。功能强大的报表统计使得用户大数据分析变的简单，
Mongoose 文档实例提供了两种主要方法来获取其普通 JavaScript 对象表示：
- .toObject() 方法：这是推荐的方法，它返回一个文档的普通 JavaScript 对象表示。此方法还可以接受选项来自定义输出（例如，是否包含虚拟属性、getter 等）。
- ._doc 属性：Mongoose 文档实例的 _doc 属性直接引用了存储文档数据的底层普通 JavaScript 对象。
通过这两种方法，我们可以剥离 Mongoose 实例的内部状态，只保留纯粹的数据。
关键考量：_id 和 __v 字段的处理
在将 Mongoose 文档转换为普通 JavaScript 对象后，我们还需要决定如何处理 _id 和 __v 字段：
- __v 字段：当复制数据到新文档时，总是应该删除 __v 字段。新文档应该由 Mongoose 自动生成其初始版本号。
-
_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 原生操作以提高效率。遵循这些最佳实践，可以确保数据复制过程的顺畅和可靠。
