企业官网建设流程全解析

📋 问题描述

症状：Flutter 应用通过 Google Play 下载安装后，点击 Google 登录按钮报错：

GoogleSignInException(code GoogleSignInExceptionCode.canceled, [16] Account reauth failed., null)

环境：

• Flutter + google_sign_in 插件
• 应用以 AAB 格式上传到 Google Play
• 用户从 Google Play 下载安装

🔍 排查过程

第 1 步：添加调试日志

由于 Release 模式下print()不输出日志，创建了一个日志收集器在应用内显示错误详情：

import 'dart:developer' as developer; class GoogleAuthLogger { static final List<String> _logs = []; static void log(String message) { final timestamp = DateTime.now().toString().substring(11, 19); final entry = '[$timestamp] $message'; _logs.add(entry); developer.log(message, name: 'GoogleAuth'); } static String getLogs() => _logs.join('\n'); static void clear() => _logs.clear(); }

在 UI 中添加"查看调试日志"按钮，登录失败时显示详细日志。

第 2 步：定位问题

通过日志发现错误发生在Google 原生认证阶段（还没到 Supabase）：

[22:46:47] 📱 触发 Google 登录界面 [22:46:49] ❌ Google 认证失败: GoogleSignInException(code GoogleSignInExceptionCode.canceled, [16] Account reauth failed., null)

错误码[16] Account reauth failed表示SHA-1 指纹不匹配。

第 3 步：检查 SHA-1 配置

检查本地 Release keystore 的 SHA-1：

keytool -list -v -keystore ~/linguadiary-release-key.jks -alias linguadiary-key-alias

输出：

SHA1: 13:0X:62:E7:BE:32:F4:E4:C1:0C:D6:04:BA:15:F7:BD:7D:49:13:C9

Google Cloud Console 中的 Android OAuth Client 已配置这个 SHA-1，但还是失败...

第 4 步：发现根本原因

应用是以AAB 格式上传到 Google Play 的，Google Play 会用自己的密钥重新签名 APK！

这意味着用户下载的 APK 签名与本地 keystore 不同。

🔑 关键知识：两个证书的区别

流程图：

开发者电脑 Google Play 用户手机 │ │ │ │ 1. 用 Upload key 签名 │ │ │ AAB 上传 │ │ ├──────────────────────────►│ │ │ │ 2. Google 用 │ │ │ App signing key │ │ │ 重新签名 APK │ │ ├──────────────────────────►│ │ │ │ │ │ 用户安装的 APK │ │ │ 签名 = App signing key│

✅ 解决方案

1. 获取 App Signing Key 的 SHA-1

1. 打开 Google Play Console
2. 选择应用 →Test and release→App integrity
3. 点击Play app signing的Settings
4. 找到App signing key certificate的 SHA-1

2. 更新 Google Cloud Console

1. 打开 Google Cloud Console - Credentials
2. 编辑 Android Release OAuth Client
3. 将 SHA-1 改为 App signing key 的 SHA-1
4. 保存

3. 清除 Google Play 服务缓存（测试设备）

由于之前用错误的 SHA-1 尝试过登录，手机缓存了旧配置：

1. 手机设置→应用→Google Play 服务
2. 存储→清除缓存
3. 重新测试

⚠️ 注意：普通用户不需要这一步，只有测试设备因缓存旧数据才需要清除。

📌 经验总结

1. AAB 上传 = Google 重新签名：必须使用 App signing key 的 SHA-1
2. APK 直接安装：使用 Upload key 的 SHA-1
3. Release 模式调试：使用dart:developer的log()函数
4. 缓存问题：测试时如遇问题，清除 Google Play 服务缓存

🔧 调试检查清单

• [ ] 确认 OAuth 同意屏幕已配置并发布（或测试账号已添加）
• [ ] 确认 Android OAuth Client 的包名正确
• [ ] 确认使用正确的 SHA-1（Google Play 下载用 App signing key）
• [ ] 确认 Web Client ID 用于serverClientId参数
• [ ] 测试设备清除 Google Play 服务缓存