Flutter集成测试中FirebaseAuth.verifyPhoneNumber回调未触发问题

• App Check 拦截请求
  你的初始化代码中激活了Firebase App Check，集成测试环境下，App Check的验证通常会失败（模拟器/测试设备无法通过安全验证），这会静默拦截Firebase Auth的请求，导致回调无法触发。
  解决：在集成测试模式下禁用App Check：

  if (!integration) {
    await FirebaseAppCheck.instance.activate();
  }
  

• Auth 模拟器未正确就绪或配置错误
  尽管配置了useAuthEmulator，但测试运行时Auth模拟器可能未完全启动，或者地址、端口不匹配；另外，Firebase Auth模拟器仅支持特定格式的测试手机号（如+16505551234这类美国测试号），非合规号码会导致请求无响应。
  解决：

  • 测试前确保Auth模拟器已完全启动，可在测试代码中添加延迟或调用模拟器健康检查接口确认就绪
  • 使用模拟器支持的测试手机号发起请求
  • 确认10.0.2.2（Android模拟器宿主机地址）和端口9099与模拟器实际配置一致

• 测试环境缺少权限或自动验证码获取失效
  正常环境中设备可自动读取短信触发verificationCompleted，但集成测试环境下，测试框架未授予READ_SMS权限，或模拟器短信接收机制未被正确处理，导致回调无法触发。
  解决：

  • 在测试代码中手动申请短信权限：

    await driver.requestPermissions(['android.permission.READ_SMS']);
    

  • 放弃自动获取逻辑，通过Firebase Auth模拟器API手动生成验证码，在测试中手动输入验证码完成流程

• 集成测试的异步事件循环隔离
  Flutter integration_test框架存在事件循环隔离，Firebase Auth的回调运行在应用自身的事件循环中，若测试代码未正确等待应用事件处理，会误以为回调未触发。
  解决：

  • 使用tester.runAsync包裹测试中的异步操作，确保测试等待应用事件循环处理完成：

    await tester.runAsync(() async {
      // 触发手机号登录操作
      await tester.tap(find.byType(ElevatedButton));
      // 等待回调触发后的UI变化（如验证码输入框出现）
      await tester.pumpAndSettle();
    });
    

  • 在回调中触发UI状态变化（如显示验证码输入框），通过测试等待UI元素出现来验证回调是否执行，而非仅依赖日志

• 测试环境日志输出被屏蔽
  你提到无日志提示，可能是测试环境下应用日志未输出到测试控制台，导致误以为回调未触发，但实际已执行。
  解决：

  • 替换自定义日志为print语句，确保测试控制台能捕获输出
  • 在回调中设置全局标记变量，测试代码中检查该变量的状态来确认回调是否执行

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