执行mvn spring-boot:run时Spring Boot应用启动失败求助

执行mvn spring-boot:run启动Spring Boot应用时出现如下错误：

[ERROR] Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:3.3.0:run (default-cli) on project test2: Process terminated with exit code: 1 -> [Help 1]

执行mvn spring-boot:run -e后得到的栈信息仅指向Mojo执行异常，无法定位具体原因，可按以下步骤排查：

• 检查端口占用
  Spring Boot默认使用8080端口，若被其他进程占用会直接启动失败。

  • Windows：执行netstat -ano | findstr :8080查看占用进程ID，再用taskkill /F /PID <进程ID>杀掉进程
  • Linux/Mac：执行lsof -i :8080查看占用进程，用kill -9 <进程ID>终止进程
    或修改application.yml/application.properties中的server.port配置更换端口。

• 提取完整应用日志
  mvn spring-boot:run -e的输出仅展示Maven插件层面的错误，需向上翻控制台日志，寻找带有ERROR或Exception标记的行，这些才是真正的启动失败原因（比如依赖冲突、数据库连接失败、配置文件语法错误等）。

• 验证JDK版本兼容性
  Spring Boot 3.3.0要求JDK 17及以上版本，执行java -version确认当前JDK版本是否符合要求，若版本过低需升级JDK。

• 清理Maven缓存并重新构建
  依赖缓存损坏可能导致启动异常，执行以下命令清理并重新构建项目：

  mvn clean install -U
  

• 直接运行可执行JAR包
  跳过Maven插件，直接编译并运行JAR包，能获取更清晰的错误日志：

  mvn package
  java -jar target/test2-*.jar
  

• 检查配置文件合法性
  检查application.yml或application.properties是否存在语法错误：

  • YAML文件需严格遵循缩进规则，禁止使用Tab键缩进
  • 数据库URL、用户名、密码等配置是否正确，避免拼写错误

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