迁移Flutter应用Firebase用户：匿名用户UID保留方案咨询

首先明确核心问题：用firebase auth:export/import迁移匿名用户时，Firebase默认会生成新UID，且客户端直接调用匿名登录会新建用户，导致和Firestore中关联旧UID的数据脱节。以下是具体解决步骤：

一、确保导入阶段保留旧UID #

1. 导出旧项目用户时，完整导出所有字段：

   firebase auth:export AllUsers.json --project my_old_project --format json
   

2. 打开导出的AllUsers.json，检查匿名用户条目，确认localId字段为旧项目的UID，同时providerUserInfo中的providerId值为anonymous。
3. 导入到新项目（确保新项目无重复UID的用户）：

   firebase auth:import AllUsers.json --project my_new_project
   

4. 登录新项目Firebase控制台→认证→用户列表，确认匿名用户的UID和旧项目完全一致。

二、客户端适配：让用户登录到保留的旧UID #

客户端直接调用signInAnonymously()会自动创建新用户，需通过自定义认证关联旧UID：

具体操作 #

1. 在新项目Firebase控制台→认证→登录方法，启用「自定义」认证提供方。
2. 后端生成自定义token（可写临时脚本实现）：
   使用Firebase Admin SDK，针对每个旧匿名用户的UID生成包含该UID的自定义token，示例Node.js代码：

   const admin = require('firebase-admin');
   admin.initializeApp({
     credential: admin.credential.applicationDefault()
   });
   
   // 替换为旧项目的匿名用户UID
   const oldUid = "xxx";
   admin.auth().createCustomToken(oldUid)
     .then((token) => {
       console.log(token);
     })
     .catch((error) => {
       console.log('生成自定义token失败:', error);
     });
   

3. 客户端迁移逻辑：
   • 读取本地存储的旧匿名用户UID（比如之前存在SharedPreferences或UserDefaults中的值）。
   • 请求后端获取对应UID的自定义token。
   • 调用自定义登录：

     String customToken = await getCustomTokenFromBackend(oldUid);
     UserCredential userCredential = await FirebaseAuth.instance.signInWithCustomToken(customToken);
     // 登录成功后，用户UID即为旧项目的UID，可直接访问Firestore中对应数据
     

4. 可选优化：登录后引导用户绑定邮箱/手机号，转为永久用户，避免后续迁移风险。

备选方案：数据映射表（不推荐） #

若无法实现自定义认证，可在Firestore中创建uid_mapping集合，每条记录存储oldUid与newUid的对应关系。客户端访问数据时，先查询映射表找到新UID，再读取对应数据。但此方式需修改所有数据访问代码，维护成本较高。

注意事项 #

• 生产环境操作前，必须在测试环境完成全流程验证，避免数据丢失。
• 导入用户前，确保新项目认证用户列表为空，防止UID冲突。
• 客户端迁移完成后，清理旧项目的认证缓存，避免残留会话干扰。

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