升级Flutter 3.10后Google登录提示未知错误求助

以下是针对该问题的排查和解决步骤：

1. 验证Google服务配置文件完整性 #

• 检查android/app/google-services.json是否为Firebase控制台最新下载版本，确保文件中的SHA-1/SHA-256指纹与本地debug/release构建的指纹完全一致。
• 确认文件内client->oauth_client->client_id值，与代码中GoogleProvider(clientId: "...")的clientId完全匹配。

2. 确认依赖版本兼容性 #

确保pubspec.yaml中相关依赖版本适配Flutter 3.10，示例兼容版本：

firebase_auth: ^4.10.0
flutterfire_ui: ^0.4.0+1
google_sign_in: ^5.4.0

执行以下命令更新并清理项目：

flutter clean
flutter pub get
flutter run

3. 配置AndroidManifest.xml回调过滤器 #

在android/app/src/main/AndroidManifest.xml的主Activity标签内添加Google登录回调的intent-filter：

<activity
    android:name=".MainActivity"
    <!-- 保留原有配置 -->
    >
    <!-- 添加以下intent-filter -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 替换为你的反向client_id，格式为com.googleusercontent.apps.xxx -->
        <data android:scheme="com.googleusercontent.apps.YOUR_CLIENT_ID" />
    </intent-filter>
</activity>

反向client_id可从google-services.json的client->oauth_client->client_id提取，例如原client_id是12345-abcdef.apps.googleusercontent.com，则scheme为com.googleusercontent.apps.12345-abcdef。

4. 启用Firebase Google登录提供者 #

登录Firebase控制台，进入Authentication > Sign-in method，确认Google登录已启用，且关联了正确的项目支持邮箱。

5. 捕获详细错误信息 #

修改SignInScreen配置，添加errorBuilder获取具体错误详情，替代模糊的“未知错误”提示：

return SignInScreen(
  headerBuilder: (context, constraints, _) {
    return Image.asset("assets/qaizenlogo.png");
  },
  footerBuilder: (context, action) {
    // 保留原有footer代码
  },
  // 添加错误捕获逻辑
  errorBuilder: (context, exception) {
    return Center(
      child: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Text('登录失败: ${exception.toString()}'),
      ),
    );
  },
);

通过具体错误信息可精准定位问题（如OAuth权限、网络配置等）。

6. 确认Android Embedding版本 #

检查android/app/src/main/AndroidManifest.xml中是否启用了v2 embedding（Flutter 3.10要求）：

<meta-data
    android:name="flutterEmbedding"
    android:value="2" />

若缺失则添加该配置，然后重新构建项目。

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