Flutter iOS端Firebase手机号认证报错（App Attestation失败）

核心问题分析 #

报错明确指向Firebase App Check的设备验证失败，Android端正常说明Firebase Auth的短信服务配置无问题，问题集中在iOS端的App Check验证环节。

排查与修复步骤 #

• 确认App Check的Apple服务配置

  1. 登录Apple开发者后台，找到你的App ID，确保App Attest服务已启用（路径：Certificates, Identifiers & Profiles → Identifiers → 选中目标App ID → 勾选App Attest并保存）。
  2. 检查Firebase控制台的App Check配置：
     • 对应iOS App的提供者选择App Attest（生产环境必须用此选项，Device Check仅适用于测试场景）。
     • 上传的Apple私钥（从Apple开发者后台生成的App Attest密钥）的Key ID、Team ID必须与开发者账号完全匹配，Bundle ID也需和上架应用一致，无拼写错误。

• 修正Flutter端App Check初始化逻辑
  确保App启动时正确初始化App Check，生产环境必须指定AppleProvider.appAttest：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    // 初始化App Check
    FirebaseAppCheck.instance.activate(
      androidProvider: AndroidProvider.playIntegrity,
      appleProvider: AppleProvider.appAttest, // 生产环境用此，测试用deviceCheckDebug
    );
    runApp(const MyApp());
  }
  

  注意：刚上架的App，Apple与Firebase的服务同步可能需要1-2小时，不要立即测试，等待一段时间再验证。

• 验证应用签名与分发环境
  上架到App Store的应用必须使用App Store分发证书签名：

  1. 打开Xcode，进入项目Build Settings，确认Code Signing Identity为App Store对应的证书，Provisioning Profile是App Store分发配置文件。
  2. 确保Firebase控制台中添加的iOS App的Bundle ID、Team ID与上架应用完全一致，无大小写或字符错误。

• 检查Firebase Auth的App Check保护配置
  登录Firebase控制台，进入App Check → 受保护资源，确认Firebase Authentication服务已被App Check保护。若之前未启用，启用后需重新发布应用配置。

• 修复认证代码中的错误
  你的代码中verificationCompleted回调里有一处明显错误：

  // 错误写法
  firebaseAuth.signInWithCredential(auth as AuthCredential)
  // 正确写法
  firebaseAuth.signInWithCredential(phoneAuthCredential)
  

  原代码将FirebaseAuth实例强制转换为AuthCredential会导致崩溃，建议先修复该问题再测试认证流程。

额外调试建议 #

• 在Xcode中运行Release版本应用，查看控制台完整日志，获取App Check初始化及验证过程的更多错误细节。
• 进入Firebase控制台的App Check页面，查看验证请求的统计数据和错误详情，可能会有更具体的失败原因提示。

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