Flutter&Dart安卓应用启动失败问题求助

可能的原因及修复步骤 #

1. 检查Flutter项目的Gradle配置文件 #

• 打开项目根目录下的android/gradle/wrapper/gradle-wrapper.properties，确认distributionUrl格式正确，无多余符号或空格，示例正确格式：

  distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip
  

• 检查android/build.gradle文件，确保Gradle插件版本与Gradle版本兼容（比如Gradle 8.4对应com.android.tools.build:gradle:7.4.2左右），避免版本不匹配引发语法错误。

2. 清理Flutter与Gradle缓存 #

• 依次执行以下命令清理缓存：

  flutter clean
  rm -rf android/.gradle
  rm -rf ~/.gradle/caches
  flutter pub get
  

• 重启VS Code后再次尝试运行模拟器。

3. 排查环境变量中的Gradle配置 #

• 检查系统环境变量GRADLE_OPTS，确认无无效参数（比如单独的-符号）：
  • Linux/macOS终端执行：echo $GRADLE_OPTS
  • Windows终端执行：echo %GRADLE_OPTS%
• 若存在异常参数，删除后重启终端再测试。

4. 验证安卓SDK与模拟器完整性 #

• 打开Android Studio的SDK Manager，确认API 34的相关组件（SDK Platform、System Images等）已完整安装，无损坏。
• 创建新的Flutter项目并使用同一模拟器运行，排查是否为当前项目的配置或依赖问题。

5. 检查VS Code的Flutter插件配置 #

• 打开VS Code设置，搜索Flutter: Run Additional Args，确认未添加无效命令行参数（比如单独的-符号）。
• 重置Flutter插件配置至默认状态后重新尝试运行。

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