如何解决运行Flutter安卓应用时flutter.gradle第1005行构建失败错误

1. 提取详细报错定位根因 #

当前报错属于通用构建失败提示，没有暴露具体问题，执行以下命令输出完整构建日志，优先查找日志中最靠前的红色报错信息，即可定位到具体问题：

flutter run -v

2. 检查SDK版本兼容性 #

打开项目android/app/build.gradle文件，确认以下配置和你本地安装的Android SDK匹配：

• Flutter 3.0及以上版本要求compileSdkVersion最低为33
• 若使用了高版本第三方依赖，同步调整minSdkVersion到依赖要求的最低版本

3. 校验Gradle与AGP版本匹配关系 #

Gradle插件（AGP）和Gradle本身版本必须严格对应，不匹配会直接触发构建失败：

• 打开android/build.gradle查看com.android.tools.build:gradle的版本号
• 打开android/gradle/wrapper/gradle-wrapper.properties查看distributionUrl对应的Gradle版本
• 两者版本需对应，例如AGP 7.4对应Gradle 7.5，AGP 8.0对应Gradle 8.0

4. 排查依赖冲突 #

• 临时注释pubspec.yaml中所有第三方依赖，写极简Hello World代码测试构建
• 若能构建成功，逐个恢复依赖即可定位到冲突的依赖包，调整对应包的版本即可

5. 配置国内镜像源 #

如果是因为网络问题拉取不到依赖，需要同时配置两处镜像：

• 系统环境变量新增PUB_HOSTED_URL、FLUTTER_STORAGE_BASE_URL两个变量配置国内Flutter镜像
• 替换android/build.gradle中所有仓库地址为国内公共镜像即可

6. 验证运行环境问题 #

• 换用安卓真机测试运行，排除模拟器本身架构不兼容（比如项目仅支持ARM架构，模拟器用了x86架构）的问题
• 关闭Android Studio、模拟器，杀掉所有Gradle、Dart进程后重启设备重试，排除进程锁死问题

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