Flutter集成firebase_performance报错：Default FirebaseApp未初始化

算力阿峰

2026-8-13

解决Firebase Performance初始化顺序问题

问题原因

Firebase Performance的Android端初始化器会在应用启动阶段（早于Flutter Dart代码执行）自动触发，而你在main.dart中调用的Firebase.initializeApp是在Flutter层面执行的，顺序滞后，导致Performance组件尝试获取FirebaseApp时出现未初始化错误。

解决方案

1. 禁用Android端自动初始化

打开android/app/src/main/AndroidManifest.xml，在<application>标签内添加以下meta-data，禁用Performance的自动收集：

<meta-data
    android:name="firebase_performance_collection_enabled"
    android:value="false" />

2. Flutter端初始化完成后手动启用

在main.dart中，确保Firebase.initializeApp执行完成后，手动开启Performance收集：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  // 手动启用Firebase Performance
  await FirebasePerformance.instance.setPerformanceCollectionEnabled(true);
  runApp(const MyApp());
}