Flutter集成Firebase手机号认证报phoneNumber为空异常如何解决

核心原因是执行verifyPhoneNumber时，传入的phoneNumber参数是空字符串，和报错提示完全匹配。
当前代码存在两个问题，其中第一个直接触发本次报错：

• 调用VerifyNumber方法前没有做入参校验，传入的phoneNumb本身是空值。可能是输入框取值失败、变量未正确赋值、或者用户没输入内容就触发了验证逻辑，直接把空字符串传给了Firebase接口。
• 代码里codeSent回调中对verificationId的赋值是无效逻辑：Dart的函数参数是值传递，回调里修改形参不会改变方法外部的变量值，后续输入验证码登录时会拿不到正确的校验ID，只是这个问题不会触发当前的空手机号报错。

1. 调用验证方法前强制做手机号校验
   传给Firebase的手机号必须是带国际区号的E.164格式（比如国内手机号要传+8613xxxxxxxxx，不能只传11位裸号），且不能为空，参考校验逻辑：

   // 从输入框取手机号时先做trim去掉首尾空格
   final rawPhone = phoneInputController.text.trim();
   if (rawPhone.isEmpty) {
     // 弹提示要求用户输入手机号
     print('手机号不能为空');
     return;
   }
   // 自动补全国际区号，根据业务所在地区调整
   final validPhone = rawPhone.startsWith('+') ? rawPhone : '+86$rawPhone';
   // 正则校验手机号格式是否符合E.164要求
   if (!RegExp(r'^\+[1-9]\d{7,14}$').hasMatch(validPhone)) {
     print('手机号格式错误');
     return;
   }
   // 校验通过再调用验证方法
   await VerifyNumber(validPhone, (vid) {
     // 拿到verificationId存到状态变量里，供后续验证码登录用
     setState(() {
       verificationId = vid;
     });
   });
   

2. 重构VerifyNumber方法，修复verificationId无法外传的问题
   去掉方法里没用的verificationId形参，改成通过回调把codeSent返回的校验ID传到外部：

   Future<void> VerifyNumber(String phoneNumb, Function(String verificationId) onCodeSent) async {
     await FirebaseAuth.instance.verifyPhoneNumber(
       phoneNumber: phoneNumb,
       verificationCompleted: (AuthCredential credential) async {
         // Android自动校验成功直接登录
         await FirebaseAuth.instance.signInWithCredential(credential);
       },
       verificationFailed: (FirebaseAuthException exc) async {
         // 细化错误打印方便排查
         if (exc.code == 'invalid-phone-number') {
           print('手机号格式无效');
         } else {
           print('验证失败：${exc.code} - ${exc.message}');
         }
       },
       codeSent: (String verificationId, int? resendToken) {
         onCodeSent(verificationId);
         // 可选：存resendToken用于后续重发验证码
       },
       codeAutoRetrievalTimeout: (String verId) {
         // 自动校验超时逻辑
       },
     );
   }
   

3. 全链路排查传参
   如果加完校验还是复现，就在VerifyNumber方法入口第一行加print('传入手机号：$phoneNumb')，确认从输入框取值到方法调用的整个链路中，没有逻辑把手机号变量覆盖为空值。

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