如何解决Gradle任务assembleDebug失败、退出码为1的报错问题

本次报错的核心原因是Gradle守护进程启动时需要绑定的UDP端口被其他进程占用，导致无法初始化文件锁通信组件，最终构建失败。

解决方案步骤 #

步骤1：终止残留的Gradle相关进程 #

Windows系统打开命令提示符（CMD）或PowerShell，执行以下命令：
taskkill /f /im java.exe

注意：该命令会终止所有运行中的Java进程，若你有其他Java应用需要保留，可先执行netstat -ano | findstr "LISTENING"找到占用端口的进程ID，再执行taskkill /f /pid 对应进程ID单独终止占用进程。

步骤2：清理Gradle缓存与锁文件 #

• 删除用户全局Gradle缓存目录：路径为C:\Users\你的用户名\.gradle下的caches、daemon文件夹
• 删除当前Flutter项目中android目录下的.gradle文件夹

步骤3：重启开发相关服务 #

• 关闭Android Studio与运行中的模拟器
• 执行命令重启ADB服务：

  adb kill-server
  adb start-server
  

• 重新打开Android Studio，启动模拟器后尝试再次运行项目

步骤4：频繁出现该问题的永久修复方案 #

打开Flutter项目android目录下的gradle.properties文件，添加以下配置：

# 临时关闭Gradle守护进程，问题解决后可删除该行重新开启
org.gradle.daemon=false
# 指定Gradle可使用的端口范围，避免和其他程序冲突
org.gradle.daemon.port=49152-65535
# 调整JVM内存上限，避免内存不足触发异常
org.gradle.jvmargs=-Xmx1024m

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