如何使用Mongoose完全替换MongoDB现有文档的schema并保留_id与并发控制

方案1：使用hydrate方法构造SchemaTwo文档实例（推荐） #

利用Mongoose的hydrate方法将原始文档的元数据映射为SchemaTwo的文档实例，既保留乐观并发控制所需的版本号校验逻辑，又可以使用SchemaTwo的规则做字段校验：

1. 确保两个Schema对应的Model绑定同一个MongoDB集合

// 声明Model时指定相同的collection名，避免写入不同集合
const ModelOne = mongoose.model('ModelOne', schemaOne, 'target_collection');
const ModelTwo = mongoose.model('ModelTwo', schemaTwo, 'target_collection');

2. 查询原始文档并构造SchemaTwo实例

// 查询原始SchemaOne文档
const originalDoc = await ModelOne.findById('12345').exec();
if (!originalDoc) throw new Error('目标文档不存在');

// 用hydrate构造SchemaTwo文档，传入原始_id、versionKey与新业务字段
const replacedDoc = ModelTwo.hydrate({
  _id: originalDoc._id,
  versionKey: originalDoc.versionKey,
  BusinessName: 'John Doe Plumbing',
  BusinessId: 'PB1234'
});

// 标记为非新文档，触发更新逻辑而非插入逻辑
replacedDoc.$isNew = false;

3. 执行保存操作

await replacedDoc.save();

保存时会自动触发SchemaTwo的字段校验，同时携带原始版本号做乐观并发校验，校验通过后会全量替换文档内容，自动删除SchemaOne定义的旧字段，_id保持不变。

方案2：临时替换当前文档关联的Schema #

如果不想额外声明SchemaTwo的Model，可以直接修改查询到的SchemaOne文档的关联Schema，再执行覆盖操作：

const originalDoc = await ModelOne.findById('12345').exec();
// 临时替换文档关联的Schema为SchemaTwo
originalDoc.schema = schemaTwo;
// 全量覆盖文档内容为符合SchemaTwo的结构
originalDoc.overwrite({
  BusinessName: 'John Doe Plumbing',
  BusinessId: 'PB1234'
});
// 执行保存，校验规则、乐观锁逻辑均正常生效
await originalDoc.save();

注意事项 #

• 两个Schema的versionKey配置必须完全一致，否则乐观并发控制会失效
• 如果出现VersionError报错，说明存在并发修改，按原有乐观锁冲突的重试逻辑处理即可
• 默认strict模式下，Schema中未定义的字段会被自动过滤，无需手动删除旧Schema的字段

内容的提问来源于stack exchange，提问作者gilpach