多环境下保持migrate-mongo生成的Mongo ID一致的最佳实践

1. 手动指定固定ObjectID #

在插入文档时显式声明_id字段，使用预先生成好的固定ObjectID值，MongoDB允许手动设置_id，只要保证同一集合内唯一即可。

修改你的插入脚本如下：

const { ObjectId } = require('mongodb'); // 确保引入ObjectId工具

let result = await db.collection("regions").insertMany([
  {
    _id: ObjectId("60d21b4667d0d8992e610c85"), // 多环境共用的固定ID
    region: "Asia",
    hostedIn: "Singapore",
    token: "asia",
    order: 1
  }
]);

注意：提前为每个需要固定的文档生成唯一ID，确保所有环境使用相同值，且不要与后续自动生成的ID冲突。

2. 基于业务唯一字段生成固定ID #

如果文档存在天然的业务唯一标识（比如示例中的token字段），可以基于该字段生成固定ID，避免硬编码的繁琐。

比如通过哈希函数将业务字段转换为符合ObjectID格式的字符串：

const { ObjectId } = require('mongodb');
const crypto = require('crypto');

function generateFixedId(uniqueKey) {
  // 生成MD5哈希后截取前12字节，转换为ObjectID格式
  const hash = crypto.createHash('md5').update(uniqueKey).digest();
  return ObjectId(hash.slice(0, 12));
}

let result = await db.collection("regions").insertMany([
  {
    _id: generateFixedId("asia"), // 基于业务唯一值生成固定ID
    region: "Asia",
    hostedIn: "Singapore",
    token: "asia",
    order: 1
  }
]);

这种方式无需维护硬编码ID，依赖业务唯一值保证多环境ID一致，更灵活易维护。

3. 设计幂等性迁移脚本（无需强制统一ID） #

如果业务逻辑不依赖文档ID的一致性，仅需要数据状态一致，可以让迁移脚本具备幂等性——即多次执行结果相同。

实现方式是插入前先通过业务唯一字段查询，不存在再插入：

const existingRegion = await db.collection("regions").findOne({ token: "asia" });
if (!existingRegion) {
  let result = await db.collection("regions").insertOne({
    region: "Asia",
    hostedIn: "Singapore",
    token: "asia",
    order: 1
  });
}

这种方式不需要统一ID，只要保证各环境的业务数据一致即可，省去维护固定ID的成本。

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