如何在Flutter项目中正确配置Firebase-Crashlytics？

你当前的配置存在几处直接导致功能不生效的问题，以下是完整可落地的正确配置流程：

核心问题定位 #

• Debug模式下主动关闭了上报开关：你在初始化代码中设置了kDebugMode时setCrashlyticsCollectionEnabled(false)，debug环境触发的所有崩溃都不会被采集上报
• 缺少必要的前置配置：未提到配置Google服务插件、初始化Firebase核心、添加Dart侧依赖，这些是Crashlytics运行的前置条件
• 测试逻辑错误：FirebaseCrashlytics.instance.crash()触发的是原生层强制崩溃，崩溃日志不会在崩溃当场输出，需要应用下次冷启动时才会完成上报，当场看控制台自然没有相关输出

分步正确配置 #

1. 补全Pub依赖 #

先在pubspec.yaml中添加必须的依赖，执行flutter pub get拉取：

dependencies:
  flutter:
    sdk: flutter
  # 必须添加Firebase核心依赖
  firebase_core: ^2.15.1
  # Crashlytics依赖
  firebase_crashlytics: ^3.3.5

建议直接在项目根目录执行flutterfire configure命令自动生成Firebase配置文件和平台初始化选项，避免手动拷贝配置出错。

2. 修正Android端Gradle配置 #

项目级android/build.gradle配置

确保buildscript的依赖中同时包含Google服务插件和Crashlytics插件，你之前的配置漏了Google服务插件：

buildscript {
  ext.kotlin_version = '1.7.10'
  repositories {
    google()
    mavenCentral()
  }
  dependencies {
    classpath 'com.android.tools.build:gradle:7.3.0'
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    // 保留你已经添加的Crashlytics插件
    classpath 'com.google.firebase:firebase-crashlytics-gradle:2.8.1'
    // 必须添加：Google服务插件
    classpath 'com.google.gms:google-services:4.3.15'
  }
}

应用级android/app/build.gradle配置

注意插件添加顺序不能乱，同时开启对应构建类型的Crashlytics配置：

// 插件顺序严格按照以下顺序
apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply plugin: 'dev.flutter.flutter-gradle-plugin'
apply plugin: 'com.google.gms.google-services'
// 保留你已经添加的Crashlytics插件，放在google-services之后
apply plugin: 'com.google.firebase.crashlytics'

android {
  // 原有编译配置、defaultConfig等内容无需修改
  buildTypes {
    release {
      signingConfig signingConfigs.debug
      // 开启release环境混淆符号表上传，方便还原崩溃堆栈
      firebaseCrashlytics {
        mappingFileUploadEnabled true
      }
    }
    debug {
      // debug环境关闭符号表上传，加快编译速度
      firebaseCrashlytics {
        mappingFileUploadEnabled false
      }
    }
  }
}

确认你已经把Firebase后台下载的google-services.json文件放到android/app目录下，否则所有Firebase服务都无法正常初始化。

3. 修正Dart侧初始化代码 #

初始化必须在Firebase核心初始化完成后执行，同时补全异步错误捕获逻辑，测试阶段临时打开debug模式上报开关：

void main() async {
  // 必须先绑定插件引擎
  WidgetsFlutterBinding.ensureInitialized();
  // 必须初始化Firebase核心，你之前的代码漏了这步
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  if (!kIsWeb) {
    if (kDebugMode) {
      // 测试阶段强制打开debug上报，正式上线可以改回false
      await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
    }
    // 捕获Flutter框架层同步错误
    FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;
    // 捕获异步未捕获错误
    PlatformDispatcher.instance.onError = (error, stack) {
      FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
      return true;
    };
  }

  runApp(const MyApp());
}

4. 正确的崩溃测试流程 #

你之前在initState直接触发崩溃、当场等日志的方式是错的，按以下步骤测试：

1. 完全停止当前运行的应用，重新执行flutter run全新安装启动
2. 不要在启动生命周期直接触发崩溃，加个按钮点击触发，避免应用启动即崩溃导致上报逻辑无法执行：

ElevatedButton(
  onPressed: () => FirebaseCrashlytics.instance.crash(),
  child: const Text("触发测试崩溃"),
)

3. 点击按钮触发崩溃，等应用完全退出后，手动重新冷启动应用，不要用热重载/热重启
4. 保持应用前台运行1-2分钟，去Firebase控制台Crashlytics面板查看上报数据，本地控制台默认不会打印Crashlytics上报日志，可以通过过滤Logcat的FirebaseCrashlytics标签查看上报过程日志。

常见排查点 #

• 必须先在Firebase控制台对应项目中手动开启Crashlytics服务，走完新手引导流程，否则上报数据不会被接收
• 测试设备需要能正常访问Google服务，国内网络环境下需要配置代理，否则会上报失败
• 所有配置修改后不要用热重载生效，必须完全停止应用重新编译安装

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