解决Flutter Web构建时dart2js失败及FlutterFire依赖错误

核心原因 #

你的项目未启用空安全（// @dart=2.9），但依赖的Firebase Web插件（如cloud_firestore_web、firebase_auth_web）已自动升级到空安全版本，导致方法签名（参数空安全修饰）不匹配，触发重写错误。测试应用能正常构建是因为新环境默认适配了空安全或使用了兼容版本。

解决步骤 #

1. 锁定Firebase插件到非空安全兼容版本 #

打开项目根目录的pubspec.yaml，明确指定Firebase相关插件的最后一个支持Dart 2.9的稳定版本，示例配置：

dependencies:
  flutter:
    sdk: flutter
  # 核心Firebase插件（非空安全版本）
  firebase_core: ^1.20.0
  cloud_firestore: ^3.4.0
  firebase_auth: ^3.6.0
  # 对应Web端插件（非空安全版本）
  cloud_firestore_web: ^2.6.0
  firebase_auth_web: ^3.3.0

注：版本号可参考各插件的Changelog，确认最后一个标注支持Dart 2.9的版本。

2. 彻底清理依赖缓存 #

执行以下命令清除旧依赖残留，避免版本冲突：

flutter clean
rm -rf pubspec.lock .dart_tool
flutter pub get

3. 强制覆盖冲突的间接依赖 #

如果执行flutter pub deps后发现有间接依赖的Firebase相关包自动升级到空安全版本，在pubspec.yaml中添加dependency_overrides强制指定兼容版本：

dependency_overrides:
  firebase_core_web: ^1.7.0

4. 带非空安全参数构建 #

执行构建时明确指定非空安全模式：

flutter build web --no-sound-null-safety

额外说明 #

• dart2js脚本已弃用的警告属于Flutter 3.0+版本的正常提示，不影响构建，核心错误为依赖版本不匹配。
• 若后续计划迁移到空安全，可逐步移除// @dart=2.9标记，升级所有依赖到空安全版本，再进行构建。

内容的提问来源于stack exchange，提问作者skillit zimberg