Flutter 登录与 Firebase 排错指南
从 FlutterFire CLI 配置起步,依次核对 Firebase 项目、Google 登录和 Apple 登录,定位 access blocked 和 Invalid Idp Response 等常见报错。
先确认 FlutterFire CLI 和目标环境
先确认 Firebase CLI 能看到目标项目,再在 Flutter 工程根目录运行 flutterfire configure。Debug 和 Release 如果使用不同的包名或 Bundle ID,要分别确认它们对应的 Firebase 应用。
- 排查 Firebase CLI 的 This tool has encountered an error
从 CLI 报错日志开始,区分工具安装故障和应用运行时登录失败。
- 核对 Flutter Flavor 的 Android 和 iOS 环境配置
查看多环境的包名、Bundle ID 和构建入口如何对应。
Google 登录失败时分开检查授权和令牌
授权页被拒时,先检查 OAuth 同意屏幕、测试账号和客户端。若授权完成后 Firebase 拒绝令牌,再核对令牌的受众与当前 Firebase 项目。Android 端还要为实际安装包所用的签名登记 SHA-1。
- 排查 Google OAuth 的 access blocked
根据授权页的提示检查同意屏幕、客户端设置和测试用户。
- 排查 Firebase Invalid Idp Response
检查 Google ID token 与 Firebase 应用配置是否对应。
- 对照 Web 端 Google 与 Firebase 登录流程
查看网页端的令牌换取步骤,便于区分 Google 授权和 Firebase 登录。
接入 Apple 登录并用目标环境验证
iOS 端先检查对应 App Target 的 Sign in with Apple 能力,再启用 Firebase 的 Apple 登录提供商。验证时可以先用同一设备、同一构建环境走通首次授权和再次登录。
- Flutter 接入 Sign in with Apple
对照 Flutter 客户端的授权流程和返回值。