Flutter Android发布版FirebaseAuth登录注册失效问题求助

问题详情 #

• 应用：集成Firebase Auth与Cloud Firestore的Flutter应用
• 异常现象：
  • iOS模拟器、TestFlight测试版，Android模拟器调试模式：功能完全正常
  • Android发布版（Google Play上架版本、本地模拟器运行release包）：登录/注册功能失效
• 已执行操作：
  • 在Firebase后台配置了Google Play签名应用的SHA-1指纹
  • 尝试在android/app/build.gradle中添加minifyEnabled true、shrinkResources true，问题未解决
• 发布版模拟器报错日志：

E/flutter ( 6802): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: type 'Null' is not a subtype of type 'Map<String, dynamic>' in type cast
E/flutter ( 6802): #0      _SignInScreenState._signin.<anonymous closure> (package:winiz/screens/auth/signin_screen.dart:98)
E/flutter ( 6802): <asynchronous suspension>
E/flutter ( 6802): #1      _SignInScreenState._signin (package:winiz/screens/auth/signin_screen.dart:96)
E/flutter ( 6802): <asynchronous suspension>

解决方案 #

1. 验证Firebase发布版配置文件 #

• 前往Google Play控制台「应用签名」模块，复制发布版SHA-1指纹，到Firebase控制台更新对应应用的指纹，重新下载google-services.json文件并替换android/app/目录下的旧文件。
• 打开google-services.json，确认client节点包含应用包名及对应发布版SHA-1指纹。

2. 修复空类型转换错误 #

报错指向signin_screen.dart第98行的强制类型转换问题，发布版优化/混淆会放大空值处理漏洞：

• 将直接强制转换改为安全判断写法：

// 原错误写法示例
final userData = snapshot.data() as Map<String, dynamic>;

// 修改为安全处理
final userData = snapshot.data() as Map<String, dynamic>?;
if (userData != null) {
  // 正常处理用户数据逻辑
} else {
  // 空值分支处理，比如提示登录失败或重新获取数据
}

• 检查所有从Firestore读取数据的代码，避免无判断的强制类型转换，统一使用空值安全语法。

3. 配置ProGuard规则防止Firebase代码混淆 #

发布版开启混淆后，Firebase核心类可能被误处理导致功能异常：

• 在android/app/proguard-rules.pro中添加以下规则：

# 保留Firebase相关类不被混淆
-keep class com.google.firebase.auth.** { *; }
-keep class com.google.firebase.firestore.** { *; }
-keep class com.google.android.gms.** { *; }

# 保留Flutter核心类
-keep class io.flutter.app.** { *; }
-keep class io.flutter.plugin.**  { *; }
-keep class io.flutter.util.**  { *; }
-keep class io.flutter.view.**  { *; }
-keep class io.flutter.**  { *; }
-keep class io.flutter.plugins.**  { *; }

• 在android/app/build.gradle的release构建类型中确保关联ProGuard配置：

buildTypes {
    release {
        signingConfig signingConfigs.release
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

4. 检查Firestore权限规则 #

发布版可能因权限限制无法访问Firestore数据：

• 临时测试可将Firestore规则改为开放（测试完成后务必恢复为安全规则）：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

若测试后功能恢复，说明权限规则存在问题，需调整为符合业务逻辑的规则（例如仅允许已认证用户访问）。

5. 启用发布版错误日志收集 #

通过Firebase Crashlytics收集更详细的发布版错误信息：

• 在main.dart中初始化Crashlytics：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_crashlytics/firebase_crashlytics.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 启用Crashlytics收集发布版错误
  FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
  
  // 捕获Flutter全局错误
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterError;
  
  runApp(const MyApp());
}

• 发布测试包后，前往Firebase控制台Crashlytics模块查看完整错误堆栈，定位具体问题。

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