FirebaseAuth用户邮箱/手机号编辑、移除及旧凭证问题咨询

一、实操验证的编辑效果与providerData结构结论 #

通过实际测试，Firebase Auth 中邮箱与手机号的编辑逻辑存在明显差异，具体如下：

• 编辑邮箱：
  • 操作完成后，原邮箱会被直接替换，providerData 中对应 email 类型的条目会更新为新邮箱，旧邮箱不再出现在列表内
  • 新邮箱需完成验证才能正式生效，部分场景下可能需要先验证用户当前身份（如敏感操作验证）
• 编辑手机号：
  • 操作完成后，原手机号不会被替换，而是新增一条 phone 类型的 providerData 条目，新旧手机号会同时存在于列表中
  • 新手机号必须完成验证才能完成绑定，验证后用户可通过新旧两个手机号登录账号

二、核心问题解答 #

1. 移除账号邮箱，仅保留手机号登录 #

Firebase Auth 没有提供直接删除主邮箱的接口，但可以通过解绑操作实现：

• 前置条件：账号已成功绑定手机号，且当前用户会话是通过手机号登录（或重新用手机号登录确保权限）
• 执行步骤：
  • 如果邮箱是通过密码登录方式关联的，调用 user.unlink('password')
  • 如果邮箱是通过第三方OAuth关联的，调用对应provider的解绑方法（如 user.unlink('google.com')，若邮箱来自谷歌登录）
  • 执行后，providerData 中的邮箱条目会被移除，账号将仅保留手机号作为唯一登录凭证
• 注意：若账号最初是用邮箱创建的，解绑前必须确保存在其他有效登录方式（即手机号），否则会抛出操作失败的错误

2. 切换登录凭证后旧凭证的处理逻辑 #

• 邮箱切换：旧邮箱会被直接从账号的登录凭证中移除，无法再用旧邮箱登录该账号，旧邮箱可正常用于注册其他新账号
• 手机号切换：默认会保留旧手机号作为额外登录凭证，用户可通过新旧两个手机号登录；若不需要旧手机号，需手动调用 user.unlink('phone') 完成移除，移除后旧手机号将不再与该账号关联

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