Flutter运行报错：@dart=2.9与dart:html问题排查及解决

1. @dart=2.9的含义与冲突：这是Dart的版本指令，用于强制代码遵循Dart 2.9的语法规则。Dart 2.12+引入了空安全特性，你更新后的Flutter自带高版本Dart（默认开启空安全），但firebase_database-6.1.2这类旧库通过@dart=2.9禁用空安全，导致版本兼容冲突，触发空安全相关错误。
2. 无效依赖文件：更新Flutter后，旧的pubspec.lock文件和依赖缓存与新版本Flutter不匹配，引发依赖解析失败。
3. dart:html未找到：dart:html是Web平台专属库，若你在Android/iOS移动端运行项目，代码或依赖中引入该库会直接报错，通常是旧版本依赖的跨平台适配缺陷导致。
4. Gradle构建失败：前面的依赖兼容性问题传导到Android构建环节，导致Gradle无法正确解析依赖或执行构建流程。

1. 解决空安全与旧依赖冲突 #

• 升级firebase_database到支持空安全的版本：在pubspec.yaml中，将firebase_database的版本修改为^7.0.0及以上（该版本开始支持空安全），例如：

  dependencies:
    firebase_database: ^10.0.0 # 替换为最新稳定版
  

• 清理依赖缓存并重新拉取：

  flutter pub cache clean
  flutter pub get
  

• 删除项目根目录下的pubspec.lock文件，再执行flutter pub get，生成适配当前Flutter版本的依赖锁文件。

2. 处理dart:html缺失问题 #

• 检查本地代码，若存在import 'dart:html';的导入，直接删除（移动端不支持该库）。
• 运行flutter pub outdated查看所有依赖的版本状态，将引入dart:html的旧依赖升级到最新跨平台兼容版本；若无法升级，替换为移动端适配的替代库。

3. 修复Gradle构建失败 #

• 清理项目构建缓存：

  flutter clean
  

  进入项目的android目录，执行：

  # macOS/Linux
  ./gradlew clean
  
  # Windows
  gradlew clean
  

• 升级Android Gradle插件与Gradle版本：
  • 打开android/build.gradle，将classpath 'com.android.tools.build:gradle'升级到与当前Flutter版本匹配的版本（例如Flutter 3.x对应插件版本7.0+）。
  • 修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，替换为对应版本的Gradle下载链接（如https\://services.gradle.org/distributions/gradle-7.4-all.zip）。

关于@dart=2.9的补充说明 #

@dart=2.9是Dart的版本覆盖指令，作用是让指定代码块强制使用Dart 2.9的运行规则，主要用于Dart 2.12引入空安全后，帮助旧库暂时规避空安全检查。但这种方式属于过渡方案，高版本Flutter默认开启空安全，会与带该指令的旧库产生兼容性冲突，因此最彻底的解决方式是升级依赖到支持空安全的版本。

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