Flutter iOS端已在FutureBuilder调用Firebase.initializeApp()仍提示未初始化

问题原因 #

• 核心触发原因：startPage.dart中调用Firebase.initializeApp()时没有加await关键字，该方法本身是异步操作，未等待初始化完成就执行后续依赖Firebase的逻辑（NotificationService初始化、AuthService用户状态监听）。安卓平台底层初始化时序恰好能赶在依赖调用前完成，iOS平台执行时序不同，就会出现依赖调用时Firebase还未初始化完成的报错。
• 潜在遗漏点：未将Firebase后台下载的GoogleService-Info.plist配置文件通过Xcode添加到iOS项目的Runner目录下，安卓端添加了对应配置所以运行正常。
• 初始化位置不规范：将Firebase初始化放在页面构建的异步逻辑中，容易出现生命周期时序问题导致初始化时机晚于依赖调用时机。

解决方案 #

1. 调整初始化位置到main函数，确保所有依赖Firebase的逻辑执行前完成初始化，修改main.dart代码如下：

... //Imports
import 'package:firebase_core/firebase_core.dart';

void main() async {
  // 必须添加该行，确保 widgets 绑定初始化完成后再执行异步初始化操作
  WidgetsFlutterBinding.ensureInitialized();
  // 等待Firebase初始化完成再启动应用
  await Firebase.initializeApp();
  runApp(MyApp());
}

// 后续MyApp、MyHomePage原有代码保持不变

2. 移除startPage.dart中冗余的Firebase初始化调用，修改init方法：

Future<void> init(BuildContext context) async {
  // 删除原有Firebase.initializeApp()调用，已在main函数中提前完成初始化
  await Provider.of<NotificationService>(context, listen: false).init();
}

3. 检查iOS端配置：打开项目ios/Runner.xcworkspace，确认从Firebase后台下载的GoogleService-Info.plist已经被添加到Runner目录下，添加时需要勾选「Copy items if needed」以及「Runner」target选项。
4. 清理缓存重新构建：执行以下命令清理旧构建缓存后再运行iOS项目：

flutter clean
cd ios
rm -rf Pods Podfile.lock
pod install --repo-update
cd ..
flutter run

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