iOS设备调用Firebase Auth的verifyPhoneNumber触发内部错误求助

问题核心 #

在iOS模拟器/真机调用FirebaseAuth.instance.verifyPhoneNumber接口时触发internal_error，提示信息仅为"An internal error has occurred, print and inspect the error details for more information."。已完成Firebase基础配置（APNS、Bundle ID），控制台测试手机号可正常使用，升级Firebase Core/Auth版本后问题依旧，反复调试触发请求频率限制。

环境信息：

• Flutter 3.24.5
• Firebase Core 3.12.0
• Firebase Auth 5.5.0

排查步骤 #

1. 抓取完整错误细节 #

internal_error是兜底提示，真实错误信息藏在FirebaseAuthException的code、message、details字段中，修改verificationFailed回调打印完整信息：

verificationFailed: (FirebaseAuthException e) {
  setState(() => isVerificationInProgress = false);
  // 打印全量错误信息
  debugPrint('Verify failed: code=${e.code}, msg=${e.message}, details=${e.details}');
  _verificationMessage = SignupPhoneNumberFragment._messages.verificationFailed;
},

2. 校验手机号格式合法性 #

针对韩国号码（+82），需严格遵循E.164标准：

• 确保用户输入的号码以0开头，处理后格式为+82+去掉首位0的纯数字串（如原号码010-1234-5678需转为+821012345678）
• 增加输入校验，禁止用户输入不带首位0的号码，避免出现+820xxxxxxxxx这类非法格式

3. 复查iOS端深层配置 #

即使已完成基础配置，仍需确认以下细节：

• GoogleService-Info.plist中的CLIENT_ID、REVERSED_CLIENT_ID、BUNDLE_ID与Xcode项目配置完全一致
• APNS推送证书已正确上传至Firebase控制台（项目设置→云消息推送→APNS标签），且证书状态有效
• Xcode中已开启Push Notifications能力，同时Background Modes下勾选Remote notifications
• Info.plist中添加FirebaseAppDelegateProxyEnabled并设置为YES

4. 测试真实号码的限制因素 #

控制台测试手机号无限制，但真实号码可能受以下规则影响：

• 确认Firebase项目所在地区允许向韩国号码发送短信
• 检查Firebase控制台→使用情况→配额，确认短信发送配额未耗尽
• 真机测试需确保设备有正常蜂窝网络（模拟器仅支持测试号码或自动验证）

5. 确认Firebase初始化流程 #

确保Firebase在App启动时完成异步初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  runApp(const MyApp());
}

避免在页面初始化后才初始化Firebase，导致Auth服务未就绪就调用接口。

6. 绕过自动验证测试 #

暂时注释verificationCompleted回调，强制走手动验证码流程，验证codeSent是否正常触发：

// verificationCompleted: (PhoneAuthCredential credential) async {
//   await _verifyWithCredential(credential);
// },

若codeSent正常触发，说明短信发送环节无问题，问题出在自动验证的APNS或设备权限配置上。

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