安卓应用集成 FirebaseAuth 实现 Google 登录的完整指南
1. 前期准备：搭建Firebase与Android应用的桥梁
第一次接触FirebaseAuth时，我也被那一堆配置项搞得头晕眼花。但后来发现只要按步骤来，整个过程其实像搭积木一样简单。我们先从最基础的Firebase项目创建开始，这里有几个新手容易踩的坑要特别注意。
1.1 创建Firebase项目的隐藏技巧
打开Firebase控制台时，建议使用隐身窗口登录。这不是为了什么神秘操作，而是避免被浏览器缓存的其他Google账号干扰。我遇到过好几次因为默认登录了个人账号，结果把企业项目建错账号的尴尬情况。
创建项目时有个小细节：项目ID一旦确定就不能修改。虽然系统会随机生成一个ID，但我建议手动设置成"公司名-应用名"的格式。上周帮客户排查问题时就发现，他们十几个项目都用默认ID，根本分不清哪个对应哪个应用。
1.2 连接Android应用的实战细节
添加Android应用时，包名的校验比想象中严格。不仅要求与build.gradle里的applicationId完全一致，连大小写都要匹配。有个客户因为包名结尾用了"Test"而不是"test"，调试了两小时才发现问题。
获取SHA-1指纹时，Android Studio的signingReport任务有时候会显示多个变体。如果你看到debug和release两个不同的SHA-1，记得把两个都添加到Firebase控制台。特别是准备上架的应用，只配置debug指纹会导致正式版无法登录。
关于google-services.json文件，有个冷知识：这个文件其实可以包含多个应用的配置。如果你有付费版和免费版两个APK，只需要在同一个Firebase项目中添加两个Android应用，生成的json文件就会包含所有配置。
2. 代码实现：从零编写登录逻辑
2.1 初始化GoogleSignInClient的深层原理
初始化代码看着简单，但里面的门道不少。那个requestIdToken参数特别关键，它就像是Firebase和Google服务之间的秘密握手协议。我见过有人直接复制代码却漏了这行，结果登录能成功但Firebase就是不认。
default_web_client_id的获取有个更简单的方法：不用去json文件里翻找，直接在Firebase控制台点击"项目设置"-"通用"，在"你的应用"卡片里就能看到。不过还是建议把它定义在strings.xml中，因为硬编码在代码里会导致每次更新配置都要重新编译。
2.2 登录流程的异常处理实战
启动登录流程的代码虽然只有几行，但异常处理才是重点。那个RC_SIGN_IN请求码可以随便定义，但千万别用0。有次我用0做请求码，结果和系统默认值冲突，导致onActivityResult根本收不到回调。
实测发现，用户取消登录时会抛出StatusCode.SIGN_IN_CANCELLED异常。这时候应该静默处理，而不是弹出错误提示。我早期版本就犯过这个错误，用户点了一下返回键就看到"登录失败"的提示，体验特别差。
2.3 处理登录结果的防坑指南
firebaseAuthWithGoogle方法里有个隐藏陷阱：idToken可能为null！虽然文档上说成功时一定有值，但我在华为设备上确实遇到过空指针异常。稳妥的做法是加个判空：
if(account.idToken.isNullOrEmpty()) { Toast.makeText(this, "获取凭证失败，请重试", LENGTH_SHORT).show() return }网络请求超时是另一个常见问题。Firebase默认超时时间很短，在弱网环境下容易失败。可以在signInWithCredential之前加个进度条，完成后再关闭。我习惯用这个代码片段：
val progressDialog = ProgressDialog(this).apply { setMessage("正在验证...") setCancelable(false) show() }3. 进阶功能与性能优化
3.1 用户状态监听的正确姿势
onStart里检查用户状态是个好习惯，但直接跳转主页可能有问题。比如用户按返回键回到登录页时，又会立即被重定向走。我的解决方案是加个标志位：
private var isFromLogin = false override fun onStart() { super.onStart() if(!isFromLogin && firebaseAuth.currentUser != null) { startActivity(Intent(this, HomeActivity::class.java)) finish() } }3.2 退出登录的完整流程
很多教程只教了firebaseAuth.signOut()，但忘记处理Google的登录状态。完整的退出应该像这样：
private fun signOut() { // 先退出Firebase firebaseAuth.signOut() // 再退出Google googleSignInClient.signOut().addOnCompleteListener { // 清除本地缓存 SharedPreferences(this).edit().clear().apply() // 更新UI updateUI(null) }.addOnFailureListener { // 即使Google退出失败，也要继续流程 updateUI(null) } }4. 生产环境必备的加固措施
4.1 安全配置检查清单
在AndroidManifest.xml里加上这个配置，可以防止授权劫持：
<activity android:name=".LoginActivity" android:exported="true" android:launchMode="singleTask"> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="your_custom_scheme" /> </intent-filter> </activity>4.2 性能监控与埋点建议
在firebaseAuthWithGoogle方法里添加Analytics事件追踪：
firebaseAuth.signInWithCredential(credential) .addOnSuccessListener { Firebase.analytics.logEvent("login_success") { param("provider", "google") } } .addOnFailureListener { e -> Firebase.analytics.logEvent("login_failed") { param("provider", "google") param("error", e.message ?: "unknown") } }最后提醒一点：在真机上测试时，记得检查设备是否安装了Google Play服务。没有的话要引导用户安装，否则所有代码都会静默失败。可以用这个代码检测：
val isAvailable = GoogleApiAvailability.getInstance() .isGooglePlayServicesAvailable(this) == ConnectionResult.SUCCESS