Flutter引入firebase_auth后出现非空返回值错误求助

AI 小北

2026-8-10

问题描述

引入import 'package:firebase_auth/firebase_auth.dart';时触发错误：
C:/flutter/.pub-cache/hosted/pub.dartlang.org/firebase_core_platform_interface-4.5.2/lib/src/pigeon/messages.pigeon.dart:198:43: Error: A non-null value must be returned since the return type 'List<PigeonInitializeResponse?>' doesn't allow null.
错误来自第三方依赖包，无法直接修改
已执行操作：flutter clean、flutter pub get、更新所有依赖、完成Firebase相关配置（google-services、build.gradle等），问题仍未解决

解决方案

以下是针对该问题的可行排查和解决步骤：

检查Flutter与Firebase依赖的版本兼容性
Firebase依赖包对Flutter SDK版本有明确要求，版本不匹配极易引发这类空安全语法问题：
- 执行flutter --version查看当前SDK版本，对照Firebase官方兼容说明确认依赖版本范围
- 若Flutter版本较低，直接升级到最新稳定版：flutter upgrade
强制指定兼容的firebase_core_platform_interface版本
报错的4.5.2版本可能和你的Flutter/Dart版本不兼容，尝试锁定一个更稳定的版本：
在pubspec.yaml的dependencies节点下添加：
```
firebase_core_platform_interface: 4.4.0
```
执行flutter pub get后重新运行项目。
检查Dart语言版本配置
确保pubspec.yaml中的Dart版本符合依赖要求，示例配置：
```
environment:
  sdk: '>=2.18.0 <3.0.0'
```
Dart版本过低会导致空安全语法处理逻辑与依赖包不一致，升级Flutter SDK即可同步升级Dart。
彻底清除依赖缓存并重新拉取
除flutter clean外，执行以下命令清除pub缓存：
```
flutter pub cache clean
```
再运行flutter pub get，确保重新下载的依赖包完整且兼容。
确认Firebase初始化逻辑正确
确保在使用firebase_auth前完成Firebase初始化，在main.dart中添加：
```
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(const MyApp());
}
```
初始化缺失可能导致依赖包内部执行异常，引发该报错。