如何在Firebase用户迁移时避免重复创建同邮箱用户

默认情况下，firebase auth:import命令会以用户UID作为唯一性判断依据，所以源项目中与目标项目邮箱相同但UID不同的用户，会被当作新用户导入，导致同一邮箱出现多个账号。要避免这种情况，需要先预处理用户数据，再执行导入，具体操作如下：

步骤1：导出两个项目的用户数据 #

先分别导出源项目（你要迁移用户的第二个应用）和目标项目（接收用户的第一个应用）的所有用户数据：

• 导出源项目用户：

  firebase auth:export SourceUsers.json --project 源项目ID
  

• 导出目标项目用户：

  firebase auth:export TargetUsers.json --project 目标项目ID
  

步骤2：过滤重复邮箱的用户 #

编写脚本对比两个导出文件，筛选出目标项目中没有的用户。以下是Node.js示例脚本：

const fs = require('fs');

// 读取两个文件的用户数据
const sourceUsers = JSON.parse(fs.readFileSync('SourceUsers.json', 'utf8')).users;
const targetUsers = JSON.parse(fs.readFileSync('TargetUsers.json', 'utf8')).users;

// 收集目标项目已存在的邮箱
const existingEmails = new Set(targetUsers.map(user => user.email));

// 过滤出仅目标项目没有的用户
const usersToImport = sourceUsers.filter(user => !existingEmails.has(user.email));

// 生成可导入的过滤后文件
fs.writeFileSync('FilteredUsers.json', JSON.stringify({ users: usersToImport }, null, 2));

运行脚本后，会得到FilteredUsers.json，里面只包含目标项目未注册的邮箱用户。

步骤3：导入过滤后的用户数据 #

使用过滤后的文件执行导入命令，确保不会创建重复邮箱的用户：

firebase auth:import FilteredUsers.json --project 目标项目ID

可选：合并重复用户的额外数据 #

如果需要将源项目中重复邮箱用户的自定义Claims、用户昵称/头像等数据合并到目标项目的现有用户中，可以使用Firebase Admin SDK编写合并脚本：

const admin = require('firebase-admin');
const fs = require('fs');

// 初始化Admin SDK（需配置目标项目的服务账号密钥）
admin.initializeApp({
  credential: admin.credential.cert('./service-account-key.json')
});

const auth = admin.auth();
const sourceUsers = JSON.parse(fs.readFileSync('SourceUsers.json', 'utf8')).users;
const targetUsers = JSON.parse(fs.readFileSync('TargetUsers.json', 'utf8')).users;

// 建立目标用户邮箱与UID的映射
const emailToTargetUid = new Map(targetUsers.map(user => [user.email, user.localId]));

// 批量合并用户数据
async function mergeUserDetails() {
  for (const sourceUser of sourceUsers) {
    const targetUid = emailToTargetUid.get(sourceUser.email);
    if (targetUid) {
      // 合并自定义Claims
      if (sourceUser.customClaims) {
        const targetUser = await auth.getUser(targetUid);
        await auth.setCustomUserClaims(targetUid, {
          ...targetUser.customClaims,
          ...sourceUser.customClaims
        });
      }
      // 合并用户资料（仅补充目标用户缺失的字段）
      const updateFields = {};
      const targetUser = await auth.getUser(targetUid);
      if (sourceUser.displayName && !targetUser.displayName) {
        updateFields.displayName = sourceUser.displayName;
      }
      if (sourceUser.photoUrl && !targetUser.photoURL) {
        updateFields.photoURL = sourceUser.photoUrl;
      }
      if (Object.keys(updateFields).length > 0) {
        await auth.updateUser(targetUid, updateFields);
      }
    }
  }
}

mergeUserDetails().catch(err => console.error('合并失败:', err));

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