本文深入探讨了在 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 takenapp.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 takenapp.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 深度解析与解决方案的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1530623.html
微信扫一扫 
支付宝扫一扫 
