MongoDB 4.4如何将LUUID迁移转换为UUID？

核心思路 #

只对**_id为LUUID类型或metadata.userUuid为LUUID类型**的文档执行转换操作，已完成转换的UUID类型字段保持不变。LUUID对应BSON类型码3，标准UUID对应类型码4，通过字段类型判断实现精准更新。

操作步骤 #

1. 筛选待更新文档（可选，用于确认范围） #

先执行查询，确认需要转换的文档数量：

db.yourCollection.find({
  $or: [
    { "_id": { $type: 3 } },
    { "metadata.userUuid": { $type: 3 } }
  ]
}).count()

2. 批量更新（适合中小集合） #

使用聚合管道形式的updateMany，自动判断字段类型并转换：

db.yourCollection.updateMany(
  {
    $or: [
      { "_id": { $type: 3 } },
      { "metadata.userUuid": { $type: 3 } }
    ]
  },
  [
    {
      $set: {
        "_id": {
          $cond: {
            if: { $eq: [{ $type: "$_id" }, 3] },
            then: { $uuid: { $toString: "$_id" } },
            else: "$_id"
          }
        },
        "metadata.userUuid": {
          $cond: {
            if: { $eq: [{ $type: "$metadata.userUuid" }, 3] },
            then: { $uuid: { $toString: "$metadata.userUuid" } },
            else: "$metadata.userUuid"
          }
        }
      }
    }
  ]
)

• $toString将LUUID转为字符串格式，$uuid再将字符串转为标准UUID类型
• $cond判断字段类型，避免重复转换已为UUID的字段
• 此操作会自动处理_id的更新，确保新_id唯一（仅类型转换，字符串值不变）

3. 分批遍历更新（适合大集合，避免锁表） #

如果集合数据量较大，推荐用forEach逐个处理，降低性能影响：

db.yourCollection.find({
  $or: [
    { "_id": { $type: 3 } },
    { "metadata.userUuid": { $type: 3 } }
  ]
}).forEach(doc => {
  const update = {};
  // 处理_id字段
  if (doc._id instanceof Binary && doc._id.sub_type === 3) {
    update._id = UUID(doc._id.toString());
  }
  // 处理metadata.userUuid字段
  if (doc.metadata?.userUuid instanceof Binary && doc.metadata.userUuid.sub_type === 3) {
    update['metadata.userUuid'] = UUID(doc.metadata.userUuid.toString());
  }
  // 仅当有需要更新的字段时执行替换
  if (Object.keys(update).length > 0) {
    db.yourCollection.replaceOne({ _id: doc._id }, { ...doc, ...update });
  }
})

注意事项 #

• 操作前必须备份数据，避免意外导致数据损坏
• 测试环境先验证转换逻辑，确认无误后再在生产环境执行
• 若集合有索引，更新_id时MongoDB会自动维护索引，无需手动处理

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