如何为已导入用户创建Firebase认证凭证并设置自定义用户ID

Firebase客户端SDK无法自定义用户ID，但Firebase Admin SDK支持创建指定自定义UID的用户，完全满足你保留旧文档ID作为Auth用户ID的需求，具体操作如下：

核心实现步骤 #

1. 初始化Firebase Admin SDK #

在你的服务端项目（比如Node.js）中配置Admin SDK，需要下载项目的服务端密钥文件以获取足够权限。

2. 批量创建带自定义UID的认证用户 #

遍历导入到Firestore的用户数据，提取旧文档ID作为uid参数，调用Admin SDK的createUser方法创建认证账号。示例代码（Node.js）：

const admin = require('firebase-admin');
const serviceAccount = require('./path-to-service-account-key.json');

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount)
});

// 从Firestore获取用户数据并批量创建Auth账号
async function createAuthUsersFromFirestore() {
  const usersSnapshot = await admin.firestore().collection('users').get();
  
  for (const doc of usersSnapshot.docs) {
    const oldUserId = doc.id; // 旧文档ID作为自定义UID
    const userData = doc.data();
    
    try {
      // 创建带自定义UID的认证用户
      const userRecord = await admin.auth().createUser({
        uid: oldUserId,
        email: userData.email,
        // 若原数据库保存了密码哈希，可直接设置以下参数
        // passwordHash: Buffer.from(userData.passwordHash, 'base64'),
        // passwordSalt: Buffer.from(userData.passwordSalt, 'base64'),
        // 无原密码则生成临时密码，后续通知用户重置
        password: generateTemporaryPassword(),
        displayName: userData.displayName
      });
      console.log(`成功创建用户：${userRecord.uid}`);
    } catch (error) {
      console.error(`创建用户${oldUserId}失败：`, error);
    }
  }
}

// 生成8位随机临时密码
function generateTemporaryPassword() {
  return Math.random().toString(36).slice(-8);
}

createAuthUsersFromFirestore();

关键注意事项 #

• 仅Admin SDK支持自定义UID：客户端SDK无权限指定UID，必须在服务端执行操作。
• UID规则检查：旧文档ID需符合Firebase Auth要求：长度1-128字符，不能包含:、/、\、[、]、#、.等特殊字符，否则创建失败。
• 密码处理：无原密码哈希时，生成临时密码后可调用sendPasswordResetEmail通知用户重置。
• 避免重复创建：创建前可调用getUser(uid)检查目标UID是否已存在，防止报错。
• 批量操作限流：大量用户创建时需注意Firebase配额，必要时添加延迟避免触发速率限制。

关于修改现有Auth用户ID的说明 #

Firebase Auth不支持修改已创建用户的UID，若之前误创建了默认UID的用户，只能删除该Auth账号，再用自定义UID重新创建，确保UID与Firestore文档ID一致。

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