运行旧Flutter项目时反复出现:app:compileFlutterBuildDebug错误求助

错误信息 #

Where:
Script 'C:\Users\admin\fvm\cache.git\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy' line: 1629

* What went wrong:
Execution failed for task ':app:compileFlutterBuildDebug'.
> Process 'command 'C:\Users\admin\fvm\cache.git\bin\flutter.bat'' finished with non-zero exit value 1

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 1m 10s
Error: Gradle task assembleDebug failed with exit code 1

已尝试flutter clean、flutter pub get及Android端设置android.enable=true，问题仍存在。

排查与解决步骤 #

• 获取详细错误日志
  当前错误仅提示进程退出码1，无具体原因。执行以下命令获取完整构建日志，定位核心问题：

  flutter build debug -v
  

  重点查看日志末尾的报错信息，比如依赖冲突、资源编译失败、SDK版本不兼容等具体提示。

• 匹配项目与Flutter SDK版本
  旧项目可能依赖特定Flutter版本，当前FVM使用的版本可能不兼容：

  1. 查看项目pubspec.yaml中的environment字段，确认要求的Flutter版本范围
  2. 使用FVM切换到对应版本：

     fvm use <指定版本号>
     

  3. 重新执行flutter clean && flutter pub get后尝试构建

• 同步Android Gradle插件与Gradle版本
  项目中Android Gradle插件和Gradle版本不匹配会导致构建失败：

  1. 打开android/build.gradle，查看classpath 'com.android.tools.build:gradle:x.x.x'的版本
  2. 打开android/gradle/wrapper/gradle-wrapper.properties，查看distributionUrl对应的Gradle版本
  3. 确保两者版本匹配（比如插件7.4.2对应Gradle 7.5+），调整后重新构建

• 排查依赖包兼容性
  旧依赖可能不兼容当前Flutter版本：

  1. 执行flutter pub outdated查看所有过时依赖
  2. 针对标记为outdated的依赖，逐个更新到兼容版本（可参考依赖包的README确认支持的Flutter版本）
  3. 更新后执行flutter pub get并重新构建

• 清理Gradle缓存
  Gradle缓存损坏可能导致构建异常：

  1. 删除本地Gradle缓存目录：C:\Users\admin\.gradle\caches
  2. 重新执行项目构建命令

• 检查Android SDK组件
  确保Android SDK安装了项目所需的组件：

  1. 打开Android Studio的SDK Manager
  2. 安装项目build.gradle中targetSdkVersion对应的SDK Platform，以及匹配版本的Build Tools

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