VSCode中Gradle Server连接失败及客户端无法连接问题求助

一、先掌握重启Gradle服务器的操作 #

• 在VSCode左侧活动栏打开Gradle面板：如果没看到，按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入"Gradle: Show Gradle Panel"即可调出
• 两种重启方式：
  • 方式1：Gradle面板顶部有个刷新图标，点击旁边的下拉箭头，选择"Restart Gradle Server"
  • 方式2：直接用命令面板，按Ctrl+Shift+P/Cmd+Shift+P，输入"Gradle: Restart Gradle Server"执行

二、逐步排查解决连接问题 #

1. 确认Gradle环境正常 #

• 打开终端，输入gradle -v，如果能正常输出Gradle版本信息，说明系统环境没问题；如果没输出，先手动安装Gradle并将其添加到系统PATH环境变量中

2. 检查VSCode插件完整性 #

• 必须同时安装Extension Pack for Java和Gradle for Java插件，Gradle插件依赖Java插件提供的基础支持
• 进入VSCode插件市场，将这两个插件先禁用再重新启用，之后重启VSCode

3. 清理Gradle缓存 #

• 找到本地Gradle缓存目录：Windows是C:\Users\<你的用户名>\.gradle\caches，Mac/Linux是~/.gradle/caches
• 删除该目录下的所有文件，重新打开项目，让Gradle重新下载依赖并初始化服务器

4. 检查项目配置文件 #

• 打开项目根目录的settings.gradle（或settings.gradle.kts）、build.gradle（或build.gradle.kts），确认没有语法错误
• 如果是学校项目，可能存在Gradle下载超时问题，打开gradle/wrapper/gradle-wrapper.properties，把distributionUrl换成国内镜像，比如阿里云的：

  distributionUrl=https://mirrors.aliyun.com/maven/gradle/distributions/gradle-<你的项目对应版本>-bin.zip
  

5. 切换Gradle运行模式 #

• 在Gradle面板里，点击项目名称旁的设置图标，选择"Gradle Settings"
• 将"Run using"选项从"Gradle Daemon"改为"Embedded"，绕过守护进程的连接问题

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