在使用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字段。遵循这些实践，可以确保数据复制操作的顺利进行，避免不必要的版本冲突错误。
