Spring Boot(Gradle)执行bootRun任务失败：端口8080占用排查求助

一、确认并释放8080端口 #

先通过命令排查端口占用情况，不管你是否主动使用过该端口：

• Windows系统：
  1. 终端执行 netstat -ano | findstr ":8080"，获取输出最后一列的进程PID
  2. 执行 taskkill /F /PID <查到的PID> 强制结束占用端口的进程
• macOS/Linux系统：
  1. 终端执行 lsof -i :8080，获取进程PID
  2. 执行 kill -9 <查到的PID> 终止占用进程

二、修改Spring Boot监听端口（无需终止现有进程） #

直接修改项目配置切换端口：

1. 打开项目的src/main/resources/application.properties（若为yml格式则打开application.yml）
2. 添加端口配置：
   • properties格式：server.port=8081（可替换为任意未被占用的端口，如8090）
   • yml格式：

     server:
       port: 8081
     

3. 重新执行./gradlew bootRun启动项目

三、排查Java环境问题（针对你的怀疑点） #

如果上述操作后仍启动失败，检查Java环境：

• 执行java -version和./gradlew -v，确认两者使用的Java版本一致（Spring Boot 3.x要求Java 17及以上，2.x要求Java 8及以上）
• 验证JAVA_HOME环境变量是否正确指向JDK安装目录
• 清理Gradle缓存：执行./gradlew clean后再重新启动项目

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