Flutter应用运行断言失败求助（Flutter Doctor检测正常）

云原生阿岚

2026-8-16

解决Flutter应用Firebase初始化断言失败问题

从报错栈可以看出，断言失败发生在firebase_core_web包的initializeApp方法中，这是Web/Windows平台Firebase初始化的核心逻辑，问题根源几乎都是Firebase配置缺失或不正确，以下是具体解决步骤：

检查Web端Firebase SDK配置
打开项目根目录下的web/index.html，确认已添加Firebase基础SDK脚本，且配置信息正确。需在<body>标签内添加类似代码（替换为你的Firebase项目配置）：

<script src="https://www.gstatic.com/firebasejs/9.23.0/firebase-app.js"></script>
<!-- 按需添加其他Firebase服务SDK，比如auth、firestore -->
<script src="https://www.gstatic.com/firebasejs/9.23.0/firebase-auth.js"></script>

确保Flutter代码中正确传入Web平台配置
如果在Flutter代码中初始化Firebase，必须为Web/Windows平台指定FirebaseOptions，示例代码如下：

await Firebase.initializeApp(
  options: const FirebaseOptions(
    apiKey: "你的API_KEY",
    authDomain: "你的AUTH_DOMAIN",
    projectId: "你的PROJECT_ID",
    storageBucket: "你的STORAGE_BUCKET",
    messagingSenderId: "你的MESSAGING_SENDER_ID",
    appId: "你的APP_ID",
  ),
);

配置信息可从Firebase控制台的「项目设置-应用-Web应用」中获取。

清理缓存并重建项目
执行以下命令清除旧构建缓存并重新安装依赖：
```
flutter clean
flutter pub get
flutter run -d chrome
```
检查依赖版本兼容性
若firebase_core_web版本与Flutter或其他Firebase包不兼容，也可能触发断言失败。修改pubspec.yaml中firebase_core依赖为最新稳定版，确保与其他Firebase依赖版本一致：
```
firebase_core: ^2.15.0 # 替换为当前最新稳定版
```
然后执行flutter pub upgrade更新依赖。