使用VSCode构建Flutter APK时出现Gradle端口占用错误如何解决
问题根因
本次报错和JAVA_HOME配置无关,核心是Gradle守护进程启动时需要绑定的本地端口被其他进程占用,导致无法正常初始化。
排查及解决步骤
- 终止所有运行中的Gradle守护进程
打开CMD或PowerShell,进入当前Flutter项目的android目录,执行命令:gradlew --stop
也可以直接打开Gradle全局缓存目录C:\Users\cs\.gradle\daemon,删除6.5版本文件夹下所有后缀为.lock的文件。 - 释放被占用的端口
执行命令查看端口占用情况:netstat -ano | findstr "LISTENING"
找到占用端口的PID后,执行命令终止对应进程:taskkill /F /PID 替换为你查到的PID号
嫌排查麻烦可以直接重启电脑,自动释放所有被占用的端口。 - (可选)配置Gradle固定端口避免复发
打开项目android目录下的gradle.properties文件,添加如下配置指定Gradle守护进程的通信端口:
端口号可自行选择1024~65535区间内未被占用的端口即可。org.gradle.daemon.port=49153 - 清理缓存重新构建
回到VSCode终端依次执行以下命令:flutter clean flutter build apk
特殊情况处理
如果执行以上操作后仍报错,检查是否开启了代理、VPN、防火墙类软件,临时关闭这类软件后再尝试构建即可。
内容的提问来源于stack exchange,提问作者Kamau Mbũgua
相关产品推荐
相关产品推荐

