Flutter真机调试报错：Gradle task assembleDebug执行失败（退出码1）

问题分析 #

报错无法找到或加载主类 org.gradle.wrapper.GradleWrapperMain核心原因是项目中Gradle wrapper的核心文件损坏、缺失，或Gradle配置路径异常。和Java有间接关联：若Java环境版本不兼容、环境变量配置错误也可能触发，但你flutter doctor检测正常，大概率是Gradle wrapper本身的问题。

修复步骤 #

1. 替换Gradle wrapper核心文件 #

• 进入Flutter项目的android/gradle/wrapper目录
• 删除其中的gradle-wrapper.jar文件
• 从能正常运行的Flutter项目中复制同版本的gradle-wrapper.jar到该目录，或根据gradle-wrapper.properties里的distributionUrl指定版本，重新下载对应jar包
• 检查gradle-wrapper.properties中的distributionUrl格式是否正确，例如应为https\://services.gradle.org/distributions/gradle-7.5-all.zip，无拼写错误

2. 重新生成Gradle wrapper #

• 打开项目的android目录，在该目录下启动CMD或PowerShell
• 执行命令：gradlew wrapper，重新生成完整的Gradle wrapper文件

3. 清理并重构项目 #

在VS Code终端进入项目根目录，依次执行：

flutter clean
flutter pub get
flutter run

4. 验证Java环境（可选） #

• 打开CMD输入java -version和javac -version，确认版本为Flutter兼容的Java 8或11，避免使用过高版本
• 检查环境变量JAVA_HOME是否指向正确的JDK目录，且该目录已添加到系统PATH中

真机运行前置确认 #

修复完成后，确保：

• 三星设备已开启USB调试和USB安装权限（需先开启开发者模式：连续点击系统版本号7次）
• 电脑已安装对应设备的USB驱动（可通过三星Smart Switch工具自动安装）
• VS Code右下角设备选择器已选中你的三星SM-J727S设备

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