Flutter中如何用Firebase单个Verification ID同时登录并更新手机号

核心问题原因 #

Firebase的PhoneAuthCredential是一次性凭证，一旦用于signInWithCredential或linkWithCredential操作后就会失效，无法再用来调用updatePhoneNumber，这就是你遇到"凭证过期"异常的根本原因。而你的需求其实不需要同时调用这两个方法，分场景处理即可：

场景1：新用户用手机号注册/登录 #

当用户首次使用手机号登录时，调用signInWithCredential后，Firebase会自动创建用户账户，并将该手机号直接绑定到用户对象上，完全不需要额外调用updatePhoneNumber。此时用户对象的phoneNumber字段会自动设置为验证的手机号，天然避免了该号码被其他用户注册。

修正后的代码（新用户场景）

// 验证OTP后生成凭证
final credential = PhoneAuthProvider.credential(
  verificationId: verificationId,
  smsCode: smsCode,
);

// 仅执行登录操作，自动完成手机号绑定
final userCredential = await FirebaseAuth.instance.signInWithCredential(credential);
// 此时userCredential.user?.phoneNumber 就是验证通过的手机号

场景2：已有用户更新绑定的手机号 #

如果当前用户已经登录（比如邮箱登录、匿名登录），需要更换绑定的手机号，正确流程是：

1. 发起手机号验证流程，获取OTP并生成PhoneAuthCredential
2. 直接调用updatePhoneNumber更新手机号，无需调用signInWithCredential

修正后的代码（更新手机号场景）

final currentUser = FirebaseAuth.instance.currentUser;
if (currentUser == null) return; // 确保用户已登录

// 验证OTP后生成凭证
final credential = PhoneAuthProvider.credential(
  verificationId: verificationId,
  smsCode: smsCode,
);

// 直接更新当前用户的手机号
await currentUser.updatePhoneNumber(credential);

为什么你的原流程会报错？ #

你之前的代码先调用signInWithCredential消耗了凭证，再用同一个凭证调用updatePhoneNumber，属于重复使用已失效的凭证，自然触发过期异常。而实际上这两个操作是冗余的，二选一就能完成你的需求——要么登录时自动绑定手机号，要么在已登录状态下直接更新手机号。

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