如何为Flutter应用生成可读性强的Firebase Crashlytics崩溃报告？

问题现象：崩溃报告仅展示插件内部调用栈，无法定位到自有业务代码位置，参考示例截图：

该问题由符号表未正确上传、Dart层错误未被完整捕获导致，按照以下步骤配置即可解决：

1. 配置全量Dart错误捕获 #

修改main函数，主动把Dart侧所有同步、异步错误上报到Crashlytics，避免默认配置遗漏上层业务栈：

import 'dart:ui';
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();

  // 捕获Dart同步异常
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  // 捕获Dart异步异常
  PlatformDispatcher.instance.onError = (error, stack) {
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
    return true;
  };

  runApp(const MyApp());
}

2. 开启符号表自动上传 #

Android端配置 #

1. 在android/build.gradle中引入Crashlytics Gradle插件：

buildscript {
  dependencies {
    // 其他依赖
    classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.9' // 可替换为最新稳定版
  }
}

2. 在android/app/build.gradle中开启符号上传：

// 末尾添加插件引用
apply plugin: 'com.google.firebase.crashlytics'

android {
  // 其他原有配置
  buildTypes {
    release {
      // 开启Native符号上传
      firebaseCrashlytics {
        nativeSymbolUploadEnabled true
        unstrippedNativeLibsDir "build/intermediates/merged_native_libs/release/out/lib"
      }
    }
  }
}

iOS端配置 #

1. 用Xcode打开iOS工程，进入TARGETS > 你的应用名称 > Build Phases，添加新的Run Script，填入以下内容：

"${PODS_ROOT}/FirebaseCrashlytics/run"
"${PODS_ROOT}/FirebaseCrashlytics/upload-symbols" --build-platform ios --flutter-project "$PROJECT_DIR/.." "$DWARF_DSYM_FOLDER_PATH/$DWARF_DSYM_FILE_NAME"

2. 进入Build Settings，搜索Debug Information Format，将Release模式的配置修改为DWARF with dSYM File，确保编译生成符号文件。

3. 混淆场景额外配置 #

如果你开启了Dart代码混淆，打包时需要添加参数导出符号文件，并上传到Firebase控制台：

• 打包命令示例：

# Android打包示例，iOS替换为ipa即可
flutter build apk --obfuscate --split-debug-info=./debug-symbols

• 打包完成后进入Firebase控制台Crashlytics > 符号文件页面，手动上传debug-symbols目录下对应平台的符号文件即可。

4. 功能验证 #

打包后主动调用FirebaseCrashlytics.instance.crash()触发测试崩溃，确认控制台上报的崩溃栈可展示自有业务代码的文件路径、行号信息。

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