在使用mongoose将文档从一个集合复制到另一个集合时，开发者常会遇到`versionerror`。该错误通常是由于直接传递mongoose文档实例，导致其内部状态（如`_id`和`__v`版本键）与新集合的预期插入行为冲突。本文将深入解析此问题的根源，并提供通过创建纯净javascript对象（包括手动构建和使用`toobject()`方法）来解决此问题的有效方法，确保数据复制的准确性和可靠性。
引言：Mongoose文档复制的常见挑战
在实际应用中，我们经常需要将一个集合中的文档复制到另一个集合。例如，将“课程列表”中的课程添加到“已选课程”中，或者将“草稿”发布到“正式文章”。尽管这看起来是一个简单的操作，但如果直接将从数据库中查询到的Mongoose文档实例传递给另一个模型的构造函数并尝试保存，Mongoose可能会抛出VersionError。
原始代码示例：
// 假设 ClassModel 和 TakenClassesModel 是不同的 Mongoose 模型app.post("/addClass", async (req, res) => { const subject_id = req.body.subject_id; const classTaken = await ClassModel.findOne({ subject_id: subject_id, }); try { // 错误发生在此处：直接将 classTaken (Mongoose文档实例) 传递给 TakenClassesModel const newClass = TakenClassesModel(classTaken); await newClass.save(); } catch (err) { console.log(err); // 可能会捕获到 VersionError: No matching document found for id "..." version 0 modifiedPaths "..." } res.json(classTaken);});
上述代码中，classTaken是一个从ClassModel查询出来的Mongoose文档实例。当它被直接传递给TakenClassesModel的构造函数时，Mongoose会尝试保留classTaken的内部状态，包括其_id和__v（版本键）。然而，TakenClassesModel集合中可能不存在具有该_id和__v的文档，Mongoose便会误认为这是一次更新操作，并因找不到匹配文档而抛出VersionError。
VersionError的根源：Mongoose文档的内部状态
Mongoose文档实例不仅仅是普通的JavaScript对象，它们携带着Mongoose内部的追踪信息，例如：
_id: 文档的唯一标识符。__v: 版本键，用于乐观锁机制，防止并发修改冲突。isNew: 标识文档是否是新创建的（尚未保存到数据库）。$isDeleted: 标识文档是否被标记为删除。$__.activePaths: 追踪文档中被修改的路径。
当一个Mongoose文档实例（如classTaken）被直接传递给另一个模型的构造函数时，Mongoose可能会尝试“继承”这些内部状态。如果目标集合中没有匹配的_id和__v，Mongoose的save()方法就会错误地尝试执行更新操作而非插入新文档，从而触发VersionError。错误信息“No matching document found for id ‘…’ version 0 modifiedPaths ‘…’”明确指出Mongoose正在尝试根据_id和__v查找并更新一个文档，但未能找到。
解决方案一：创建纯净的JavaScript对象
解决VersionError的关键在于，在将数据传递给新模型的构造函数之前，剥离Mongoose文档实例的内部状态，使其成为一个纯净的JavaScript对象。这样，Mongoose就会将其视为一个全新的文档进行插入。
一种直接的方法是手动创建一个新的JavaScript对象，并从源文档中复制所需的字段。
app.post("/addClass", async (req, res) => { const subject_id = req.body.subject_id; const classTaken = await ClassModel.findOne({ subject_id: subject_id, }); if (!classTaken) { return res.status(404).json({ message: "Class not found." }); } try { // 创建一个纯净的JavaScript对象，只包含需要复制的字段 const classDataToCopy = { _id: classTaken._id, // 如果希望保留原始_id，则包含 rating: classTaken.rating, title: classTaken.title, // ... 其他需要复制的字段 }; // 将纯净的JavaScript对象传递给 TakenClassesModel const newClass = new TakenClassesModel(classDataToCopy); await newClass.save(); // Mongoose会将其视为新文档插入 res.json(newClass); // 返回新创建的文档 } catch (err) { console.error("Error copying class:", err); res.status(500).json({ message: "Failed to add class.", error: err.message }); }});
这个方法之所以有效，是因为classDataToCopy是一个不带任何Mongoose内部状态的普通JavaScript对象。当new TakenClassesModel(classDataToCopy)被调用时，Mongoose会正确地将其识别为一个全新的文档，并执行插入操作。
解决方案二：利用toObject()方法获取纯净对象（推荐）
手动复制字段虽然有效，但当文档字段较多时会显得繁琐且容易出错。Mongoose提供了一个更优雅、更健壮的方法来获取文档的纯净JavaScript对象：document.toObject()。
toObject()方法会返回一个普通JavaScript对象，其中包含文档的所有路径（字段），并可以配置是否包含虚拟属性、getter、版本键等。
app.post("/addClass", async (req, res) => { const subject_id = req.body.subject_id; const classToCopy = await ClassModel.findOne({ subject_id: subject_id, }); if (!classToCopy) { return res.status(404).json({ message: "Class not found." }); } try { // 使用 toObject() 方法获取纯净的JavaScript对象 // 选项 { versionKey: false } 确保不包含 __v 字段 // 选项 { _id: false } 可以选择不包含 _id，让 Mongoose 生成新的 const plainObject = classToCopy.toObject({ versionKey: false }); // 如果希望新文档拥有新的 _id，则从 plainObject 中删除它 delete plainObject._id; // 将纯净的JavaScript对象传递给 TakenClassesModel const newClass = new TakenClassesModel(plainObject); await newClass.save(); res.json(newClass); } catch (err) { console.error("Error copying class using toObject():", err); res.status(500).json({ message: "Failed to add class.", error: err.message }); }});
toObject()方法的优势在于：
全面性：它会自动包含文档中的所有字段，无需手动列举。可配置性：可以通过选项控制输出对象的行为，例如是否包含虚拟属性、getter、版本键等。{ virtuals: true }: 包含虚拟属性。{ getters: true }: 运行 getter。{ versionKey: false }: 不包含 __v 字段。{ transform: function(doc, ret, options) { … } }: 在返回前对对象进行转换。
_id处理策略
在跨集合复制文档时，_id的处理是一个重要考量：
保留原始 _id: 如果你希望新集合中的文档与源文档拥有相同的 _id，则在创建纯净对象时，确保 _id 字段被包含（如plainObject._id = classToCopy._id或在toObject()后不删除_id）。Mongoose在插入时会尝试使用这个提供的_id。生成新的 _id: 如果你希望新集合中的文档拥有一个全新的 _id，则在创建纯净对象时，不包含 _id 字段（如delete plainObject._id）。Mongoose在保存时会自动为新文档生成一个唯一的 _id。
通常情况下，当复制文档到另一个集合时，我们更倾向于生成新的 _id，以避免潜在的_id冲突，除非有特定业务需求要求保留。
注意事项与最佳实践
Schema一致性：确保目标集合的Mongoose Schema (TakenClassesModel) 能够兼容源文档的所有字段。如果目标Schema中缺少某些字段，这些字段将不会被保存。性能考量：上述方法适用于复制单个或少量文档。对于大规模的数据复制，例如将一个集合的所有文档迁移到另一个集合，或者基于复杂条件进行批量复制，使用Mongoose在应用层进行查询和保存可能效率低下。在这种情况下，可以考虑利用MongoDB的聚合管道（Aggregation Pipeline）操作，如$match结合$out或$merge操作，在数据库层面直接完成数据复制，这通常更高效。错误处理：始终将文档操作包裹在try-catch块中，以便优雅地处理数据库操作可能出现的错误。原子性：如果复制操作涉及多个文档且需要保证原子性（即要么全部成功，要么全部失败），可以考虑使用MongoDB的事务功能。
总结
当使用Mongoose将文档从一个集合复制到另一个集合时，为了避免VersionError，核心原则是：在将源文档传递给目标模型的构造函数之前，务必将其转换为一个纯净的JavaScript对象，剥离Mongoose文档实例的内部状态。
推荐的方法是使用Mongoose文档实例的toObject()方法，并根据需求配置其选项（例如，{ versionKey: false }），然后根据是否需要保留原始_id来处理_id字段。遵循这些实践，可以确保数据复制操作的顺利进行，避免不必要的版本冲突错误。
以上就是Mongoose跨集合复制文档的VersionError解析与最佳实践的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1529667.html
微信扫一扫 
支付宝扫一扫 
