【Spring Boot项目启动失败原因汇总】

最新推荐文章于 2025-03-14 15:30:39 发布

吴昌泰WCT

最新推荐文章于 2025-03-14 15:30:39 发布

阅读量1.5k

点赞数 7

分类专栏：技术实践文章标签： spring boot

本文链接：https://blog.csdn.net/qq_33545255/article/details/144325204

版权

技术实践专栏收录该内容

71 篇文章

订阅专栏

如果你觉得这篇文章对你有帮助，请不要吝惜你的“关注”、“点赞”、“评价”、“收藏”，你的支持永远是我前进的动力~~~

Spring Boot项目启动失败原因汇总

Spring Boot项目的启动失败可能由多种原因引起，以下是一些常见的问题及其解决方案，包括代码示例和使用例子。

1. 项目不被IDE识别为Maven项目

原因： IDEA没有将其识别为一个Maven项目。

解决方案：

如果右侧有Maven项目，刷新一下。
左侧项目鼠标右键，添加Maven框架支持。若没有选择Maven，则选择Maven，然后右下角点击OK即可。导入后再刷新一下Maven即可。
创建项目时，右下角有可能会弹框：load maven project。若出现，说明IDEA主动问你是否要加载为Maven项目，点击OK即可。

2. 相关依赖没有找到或报红

原因： 依赖没有下载到本地或者本地文件残缺。

解决方案：

删除下载的依赖文件，在Maven本地文件里删除对应的即可。比如此处是org文件夹->springframework文件夹->boot文件夹->内的spring-boot-maven-plugin文件。若是在不知道咋删，全部删除重新下载也行。

3. JDK版本不一致

原因： 使用的JDK版本与Spring Boot版本不匹配。Spring Boot 3.x默认使用JDK17，17以下都不行，17以上可以。2.x则一般情况下都可以。

解决办法：

修改JDK版本。通常需要修改三个地方：依赖处、项目结构、设置里的Java Compiler。

4. application.yml配置文件格式问题

原因： application.yml文件格式错误，编辑的时候一般都是jdk格式得改成UTF-8。

解决办法：

将application.yml文件的编码格式从JDK默认格式转换为UTF-8。

5. pom.xml中版本不一致

原因： 特别是与Eureka依赖相关的Spring Boot版本冲突。

解决办法：

查看pom.xml中的依赖，确保版本一致。例如，如果创建时是2.4.3版本改成2.2.12版本和eureka依赖的版本一致就可以正常运行了。

6. 端口被占用

原因： 无法启动应用程序，出现端口被占用的错误。

解决办法：

查找占用端口的进程：使用命令行（Windows下为 netstat -ano，Linux下为 lsof -i:端口号）查找占用了相应端口的进程。
结束进程：根据进程ID（PID）结束占用端口的进程。在Windows可以使用 taskkill /F /PID 进程ID，在Linux可以使用 kill -9 进程ID。
修改应用程序端口：在 application.properties 或 application.yml 中修改 server.port 配置，将端口更改为未被占用的端口。

7. RESTful API请求返回404错误

解决过程：

检查URL：确保请求的URL路径正确，包括路径参数（如果有）。
检查Controller：确保Controller中的 @RequestMapping 或 @GetMapping 等注解配置正确。
检查方法：确保请求的HTTP方法与Controller方法的映射正确。

8. 中文乱码问题

原因： 各方面规定的编码格式不一致导致的。

解决办法：

检查页面编码格式，一般来说都是国际统一编码UTF-8。
检查项目中编码格式，Spring Boot的项目统一编码格式可以在 application.properties 或 application.yml 文件中设置：

## http编码
spring.http.encoding.charset=UTF-8
## 消息编码
spring.messages.encoding=UTF-8
## 文件编码
spring.banner.charset=UTF-8

检查部署应用服务器的编码格式，可以在项目配置文件中配置，也可以在应用服务器配置文件中配置：

## tomcat编码
server.tomcat.uri-encoding=UTF-8

一般通过以上三种问题排查之后都会解决乱码问题，如果实在还没的话可以debug查看是否前台传过来之后就乱码，可以通过配置类的方式来解决或者代码中强制转换类型。

总结

Spring Boot项目启动失败的原因多种多样，包括IDE配置问题、依赖问题、配置文件问题、环境问题等。解决这些问题需要对Spring Boot的启动流程和配置有深入的理解。通过仔细检查配置、依赖和代码，以及对常见错误的识别和理解，可以有效地解决这些问题。希望上述汇总能帮助开发者快速定位并解决Spring Boot项目启动失败的问题。