Flutter Firebase OTP验证失败：验证码一致却提示过期

你遇到的问题是输入正确OTP却提示sms code has expired，可以从以下几个方向排查解决：

1. 校验ID（verificationId）不匹配或过期 #

Firebase发送的每个OTP都会绑定唯一的verificationId，旧的verificationId无法验证新的OTP，反之亦然。

• 检查你保存verificationId的逻辑：在verifyPhoneNumber的codeSent回调中，必须保存最新返回的verificationId，不能复用之前缓存的旧值。
• 重新发送OTP时，必须重新调用verifyPhoneNumber获取新的verificationId，不能继续使用之前的。

2. OTP本身已过有效期 #

Firebase的短信验证码默认有效期为5分钟，如果用户输入时超过这个时间，会直接判定过期：

• 在UI上添加倒计时提示，让用户清楚剩余有效时间；
• 当用户点击“重新发送”时，立即触发新的OTP请求，替换旧的verificationId和OTP。

3. 设备时间偏差过大 #

如果用户设备的系统时间与实际时间偏差超过一定范围，Firebase会认为OTP已过期：

• 提示用户检查设备时间设置，开启“自动同步时间”功能。

4. 代码逻辑优化建议 #

正确保存verificationId的示例 #

确保在发送OTP时正确捕获并保存最新的verificationId：

void sendOtp(String phoneNumber) async {
  await _firebaseAuth.verifyPhoneNumber(
    phoneNumber: phoneNumber,
    verificationCompleted: (PhoneAuthCredential credential) async {
      // 自动完成验证的逻辑（如安卓设备自动读取短信）
    },
    verificationFailed: (FirebaseAuthException e) {
      // 处理发送失败（如手机号格式错误）
    },
    codeSent: (String verificationId, int? resendToken) {
      // 保存最新的verificationId和重发令牌
      _verificationId = verificationId;
      _resendToken = resendToken;
    },
    codeAutoRetrievalTimeout: (String verificationId) {
      // OTP自动读取超时，可提示用户手动输入或重新发送
    },
  );
}

验证OTP时传递正确的verificationId #

调用你的verifyOtp函数时，必须传入上述步骤中保存的最新_verificationId，而不是旧的缓存值：

// 示例调用
verifyOtp(
  context: context,
  verificationId: _verificationId, // 这里必须是最新的
  userOtp: userInputOtp,
  onSuccess: () {
    // 验证成功后的逻辑
  },
);

额外优化点 #

• 避免在代码中使用!强制解包user，改成空安全的判断：

  User? user = (await _firebaseAuth.signInWithCredential(creds)).user;
  if (user != null) {
    _uid = user.uid;
    onSuccess();
  }
  

• 在codeAutoRetrievalTimeout回调中添加提示，告知用户OTP已超时，引导重新发送。

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