Flutter Firebase Auth邮箱登录提示客户端请求被拦截如何解决

问题描述 #

基于Flutter/Firebase技术栈开发应用时，安卓端调用邮箱密码登录Firebase接口抛出如下错误：

[firebase_auth/unknown] com.google.firebase.FirebaseException: An internal error has occurred. [ Requests from this Android client application com.google.firebase are blocked. ]

已完成的前置排查项：

• google-services配置文件已正确放置
• 所有Gradle配置校验无误
• Firebase相关依赖均已升级到最新版本
• Firebase控制台已开启邮箱登录方式
• 本地应用包名与Firebase控制台配置的包名完全一致

涉及的业务代码如下：

1. 认证状态监听逻辑

StreamBuilder<User?>(
  stream: FirebaseAuth.instance.authStateChanges(),
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      return const FeedRoute();
    } else {
      return const LoginWidget();
    }
  },
));

2. 登录页触发的登录方法

Future<void> signIn() async {
  try {
    final UserCredential authResult =
        await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: emailController.text.trim(),
      password: passwordController.text.trim(),
    );
  } catch (e) {
    print(e);
  }

  Navigator.of(context).pushReplacementNamed('/feed_route');
  }
}

排查方向与解决思路 #

1. 先修复现有代码的逻辑缺陷 #

当前登录方法存在明显逻辑问题：无论登录请求成功还是抛出异常，代码都会无条件执行路由跳转到Feed页，catch块仅打印错误未做流程拦截，会干扰问题定位。先调整登录逻辑，仅在登录成功后执行跳转，异常分支单独做错误提示：

Future<void> signIn() async {
  try {
    final UserCredential authResult =
        await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: emailController.text.trim(),
      password: passwordController.text.trim(),
    );
    // 登录成功再跳转
    if (authResult.user != null) {
      Navigator.of(context).pushReplacementNamed('/feed_route');
    }
  } catch (e) {
    print(e);
    // 异常场景做错误提示，不执行跳转
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text("登录失败：${e.toString()}"))
    );
  }
}

2. 核心排查点：API密钥应用限制配置不匹配 #

这个报错的最常见诱因是Firebase关联的Android API密钥配置了应用访问限制，但登记的包名、签名哈希值和当前运行的安装包不匹配，导致请求被Firebase后端拦截：

• 在项目根目录执行./gradlew signingReport，获取当前构建变体使用的签名文件对应的SHA1、SHA256哈希值
• 打开Firebase控制台项目设置页，在安卓应用配置板块，把获取到的调试签名、正式签名的所有哈希值都补充登记，保存后等待配置生效
• 进入对应项目的Google Cloud API凭证管理页，找到Firebase Auth服务使用的Android API密钥，检查应用限制规则：如果选择了「限制特定安卓应用访问」，必须确保列表内的应用条目包名、签名哈希和当前运行的包完全一致；排查阶段可以临时设置为「无限制」测试，确认问题根因后再补全限制规则
• 配置修改后等待3-5分钟同步，卸载手机上已安装的旧包，重新编译安装后再测试

3. 配置文件与构建缓存排查 #

• 删除android/app目录下原有的google-services.json文件，重新从Firebase控制台下载对应项目、对应包名的最新配置文件放入对应目录，不要手动修改json文件内的字段
• 执行flutter clean清理所有构建缓存，重新执行flutter pub get拉取依赖后再编译测试

4. 网络环境排查 #

如果本地网络存在对Firebase服务域名的拦截、代理规则配置错误，也可能触发这类通用拦截报错，切换到可正常访问Firebase服务的网络环境后重试。

5. 依赖兼容性排查 #

即使所有依赖都升级到最新版，也可能存在跨大版本不兼容的问题，可以先使用经过验证的稳定版依赖组合测试：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.24.2
  firebase_auth: ^4.15.3

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