Spring Boot 启动失败？十大常见启动异常分析与解决方案

本文链接：https://blog.csdn.net/zfh1005/article/details/148453930

Spring Boot 以其“开箱即用”的特性极大地简化了 Spring 应用的开发和部署。然而，即使是如此“智能”的框架，在实际开发过程中，我们也常常会遇到各种启动失败的问题。这些问题可能源于配置错误、依赖冲突、端口占用、数据库连接问题等等。

当 Spring Boot 应用启动失败时，控制台通常会输出大量异常堆栈信息。面对这些看似复杂的信息，如果能快速定位问题根源，将大大节省调试时间。

本文将总结 Spring Boot 开发中十大最常见的启动异常，深入分析其产生的原因，并提供详细的解决方案，帮助你快速“抢救”你的 Spring Boot 应用！

1. `Port already in use` (端口已被占用)

异常信息示例：

Web server failed to start. Port 8080 was already in use.

在这里插入图片描述

原因分析：
这是最常见的启动失败原因之一。当你的 Spring Boot 应用尝试启动时，它会默认监听 8080 端口。如果该端口已经被其他应用程序（例如另一个 Spring Boot 应用、Tomcat、Nginx 等）占用，就会出现此错误。

解决方案：

更改 Spring Boot 应用的端口：
在 application.properties 或 application.yml 中修改：
```
# application.properties
server.port=8081
```
```
# application.yml
server:
  port: 8081
```

查找并终止占用端口的进程：

Linux/macOS:

sudo lsof -i :8080
# 找到 PID 后
sudo kill -9 <PID>

Windows:

netstat -ano | findstr :8080
# 找到 PID 后
taskkill /pid <PID> /f

检查是否有其他应用在后台运行： 确保没有其他 IDE 或命令行启动的 Spring Boot 实例。

2. `No qualifying bean of type '...' available` (找不到合适的 Bean)

异常信息示例：

org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.example.demo.service.UserService' available: expected at least 1 bean which qualifies as autowire candidate.

在这里插入图片描述

原因分析：
这个异常表示 Spring 容器在尝试注入某个 Bean 时，找不到对应的 Bean 定义。常见原因包括：

忘记添加 @Component, @Service, @Repository, @Controller 等注解。
Bean 所在的包没有被 Spring Boot 扫描到。
Bean 定义错误，例如构造函数参数无法满足。
循环依赖。

解决方案：

检查 Bean 定义注解： 确保需要被 Spring 管理的类都添加了相应的 Spring 组件注解。
检查包扫描范围： 确保你的 Bean 所在的包在 Spring Boot 应用的扫描路径下。默认情况下，Spring Boot 应用会扫描启动类所在包及其子包。
- 如果 Bean 在其他包，可以在启动类上添加 @ComponentScan("com.example.other.package")。
检查 Bean 的构造函数和依赖： 确保所有依赖都能被正确注入。
排查循环依赖： 复杂的依赖关系可能导致循环依赖，Spring 可能会报错。尝试重构代码或使用 @Lazy 注解。

3. `Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.` (数据源配置失败)

异常信息示例：

org.springframework.boot.autoconfigure.jdbc.DataSourceProperties$DataSourceBeanCreationException: Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.