Firebase控制台无法通过手机号添加用户的技术咨询

嘿，我来帮你搞定这个问题～首先得说清楚：Firebase控制台的用户界面确实不支持直接手动添加手机号认证的用户，更别说批量导入了——它只支持邮箱/密码、第三方登录（比如Google、Facebook）这类用户的手动创建。要批量导入手机号用户，得用程序化的方式，下面给你两种靠谱的方法：

为什么控制台没法直接添加手机号用户？ #

Firebase的手机号认证依赖于短信验证流程，控制台没有提供手动创建无验证手机号用户的入口，所以必须通过Admin SDK或者CLI工具来实现批量导入。

方法一：用Firebase Admin SDK编写脚本批量导入 #

这种方法灵活性更高，适合需要自定义逻辑的场景，比如导入时同时设置用户昵称、自定义声明等。

步骤： #

1. 获取服务账号密钥：
   打开Firebase控制台→进入你的项目→点击左上角「设置」图标→「项目设置」→「服务账号」→点击「生成新的私钥」，下载JSON格式的密钥文件，保存到本地项目目录。

2. 准备用户数据：
   把要导入的手机号整理成JSON或CSV文件，注意手机号必须是E.164格式（比如"+1234567890"、"+8613800138000"），可以附带可选字段比如displayName（用户昵称）。
   示例JSON文件（users.json）：

   [
     {"phoneNumber": "+8613800138000", "displayName": "张三"},
     {"phoneNumber": "+8613900139000", "displayName": "李四"}
   ]
   

3. 编写Node.js脚本：
   先安装依赖：

   npm install firebase-admin fs
   

   然后创建脚本文件（batch-import.js）：

   const admin = require('firebase-admin');
   const fs = require('fs');
   
   // 初始化Admin SDK
   const serviceAccount = require('./your-service-account-key.json'); // 替换成你的密钥文件路径
   admin.initializeApp({
     credential: admin.credential.cert(serviceAccount)
   });
   
   // 读取用户数据
   const users = JSON.parse(fs.readFileSync('./users.json', 'utf8'));
   
   // 批量创建用户
   async function importUsers() {
     let successCount = 0;
     let errorCount = 0;
   
     for (const user of users) {
       try {
         await admin.auth().createUser({
           phoneNumber: user.phoneNumber,
           displayName: user.displayName || null
         });
         successCount++;
         console.log(`成功导入用户：${user.phoneNumber}`);
       } catch (error) {
         errorCount++;
         console.error(`导入用户失败 ${user.phoneNumber}：${error.message}`);
       }
     }
   
     console.log(`\n导入完成：成功${successCount}个，失败${errorCount}个`);
   }
   
   importUsers();
   

4. 运行脚本：

   node batch-import.js
   

方法二：用Firebase CLI的批量导入工具 #

如果不需要复杂逻辑，用Firebase CLI的auth:import命令更简单快捷。

步骤： #

1. 安装并登录Firebase CLI：

   npm install -g firebase-tools
   firebase login
   

2. 准备CSV导入文件：
   创建CSV文件（users.csv），列名要包含phoneNumber，可选添加displayName等字段，示例：

   phoneNumber,displayName
   "+8613800138000","张三"
   "+8613900139000","李四"
   

3. 执行导入命令：
   替换成你的项目ID，运行：

   firebase auth:import users.csv --project your-project-id
   

   注意：如果你的用户没有密码（手机号认证用户默认不需要密码），不需要指定哈希算法参数，CLI会自动处理。

重要注意事项 #

• 确保你的Firebase项目已经启用手机号认证：控制台→「Authentication」→「登录方法」→找到「手机号」并启用。
• 手机号必须严格遵循E.164格式，否则会导入失败。
• 导入前建议先测试少量数据，避免批量出错。
• 如果遇到重复手机号，工具会抛出错误，记得在脚本或导入后查看错误日志处理。

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