Flutter项目升级firebase_core至0.7.0后初始化Firebase出现栈溢出如何解决

该版本对应Flutter 2.x生态，所有Firebase相关依赖必须严格对齐版本，任意版本错位都可能触发内部逻辑循环。

版本对齐前置校验 #

先核对pubspec.yaml中的依赖版本是否符合兼容要求，禁止使用高于匹配版本的其他Firebase组件，否则会出现初始化逻辑的循环依赖：

• firebase_core: ^0.7.0
• firebase_auth: ^0.20.1
• cloud_firestore: ^0.16.0
• firebase_storage: ^7.0.0

栈溢出高发触发点与修复 #

1. 初始化位置错误引发的递归循环 #

这是该版本栈溢出的最高发原因：如果将Firebase.initializeApp()放在根Widget的build方法、页面生命周期回调等会被重复触发的逻辑中，初始化完成后的状态通知会再次触发重建，重建过程又会重复调用初始化，形成无限递归最终耗尽栈空间。

• 常见错误写法：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 每次build都会触发初始化，形成循环
    Firebase.initializeApp();
    return MaterialApp(home: HomePage());
  }
}

• 正确写法：将初始化逻辑上移至main函数，在runApp调用前全局仅执行一次初始化：

void main() async {
  // 0.7.0版本强制要求先完成Flutter绑定初始化
  WidgetsFlutterBinding.ensureInitialized();
  // 同步等待初始化完成后再启动App
  await Firebase.initializeApp();
  runApp(MyApp());
}

2. 缺失绑定初始化引发的平台通道递归 #

如果跳过WidgetsFlutterBinding.ensureInitialized()直接调用Firebase.initializeApp()，部分设备上会出现平台通道消息循环，原生层和Dart层反复传递初始化请求，最终触发栈溢出。

• 校验规则：WidgetsFlutterBinding.ensureInitialized()必须放在所有Flutter插件调用之前，不能放在App启动后的页面逻辑中执行。

3. 多位置重复初始化引发的循环等待 #

如果项目在全局状态管理初始化、页面构造函数等位置重复调用Firebase.initializeApp()，会因为初始化状态的重复校验形成循环等待，耗尽栈空间。

• 修复要求：删除所有非main函数中的Firebase.initializeApp()调用，全局仅保留一次初始化逻辑。

4. 平台配置缺失引发的初始化重试循环 #

如果Android、iOS端的Firebase配置文件不完整，SDK会反复尝试拉取缺失的配置信息，触发初始化逻辑的循环重试。

• 校验要点：
  • Android端确认android/app/build.gradle顶层应用了com.google.gms.google-services插件，插件版本不低于4.3.0
  • iOS端在Info.plist中添加FirebaseAppDelegateProxyEnabled配置项，值设为NO，避免AppDelegate代理方法的循环调用

快速定位栈溢出位置的调试方法 #

在main函数入口添加错误捕获逻辑，打印触发栈溢出的完整调用堆栈，直接定位递归触发的代码位置：

void main() {
  FlutterError.onError = (FlutterErrorDetails details) {
    if (details.exceptionAsString().contains('Stack Overflow')) {
      // 打印完整堆栈，定位递归调用链
      debugPrintStack(stackTrace: details.stack, label: '栈溢出堆栈');
    }
  };
  // 原有初始化逻辑
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

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