Spring Boot 项目启动时报错，是每个Java开发者都会遇到的事。这篇文章整理了10种最常见的启动报错，附解决方案。
1. Failed to configure a DataSource
报错信息：
Failed to configure a DataSource: 'url' attribute is not specified
原因：项目中引入了数据库依赖，但没有配置数据源。
解决：
如果不需要数据库，在启动类上排除自动配置：
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})如果需要数据库，检查 application.yml 中的数据源配置是否正确。
2. Port was already in use
报错信息：
Web server failed to start. Port 8080 was already in use.
原因：端口被占用。
解决：
找到占用端口的进程并关闭，或在配置中换一个端口：
server: port: 8081
3. 数据库驱动版本不匹配
报错信息：
java.lang.AbstractMethodError: com.mysql.cj.jdbc.Driver.getMajorVersion()
原因：MySQL驱动版本与数据库版本不匹配。
解决：
MySQL 8.x 使用较新版本的驱动：
<dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency>
4. 包扫描路径不对
现象：项目能启动，但访问接口返回404，或者Autowired注入失败。
原因：启动类的位置不对，默认扫描启动类所在包及其子包。
解决：
确保启动类放在最外层包下
或者手动指定扫描路径：
@SpringBootApplication(scanBasePackages = {"com.example.controller", "com.example.service"})5. Maven依赖冲突
报错信息：
java.lang.NoSuchMethodError: com.google.common.collect.FluentIterable
原因：项目中有多个版本的同一个jar包冲突。
解决：
在 pom.xml 中用
<exclusions>排除冲突的依赖：
<dependency> <groupId>xxx</groupId> <artifactId>xxx</artifactId> <exclusions> <exclusion> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> </exclusion> </exclusions> </dependency>
6. Lombok相关的报错
报错信息：
java: cannot find symbol symbol: method getXxx()
原因：IDE没有安装Lombok插件，或者没有启用注解处理器。
解决：
IDEA安装Lombok插件：File → Settings → Plugins → 搜索Lombok
启用注解处理器：Settings → Build → Compiler → Annotation Processors → Enable
7. 配置文件格式错误
现象：启动时报YamlPropertySourceLoader相关错误。
原因：yml文件的缩进或格式不正确。
解决：
yml对缩进敏感，检查每层的空格数
冒号后面必须有一个空格
8. Whitelabel Error Page
现象：启动成功，但访问页面显示Whitelabel Error Page。
原因：没有配置Controller，或者Controller路径不对。
解决：
确认Controller类上加了
@RestController或@Controller确认
@RequestMapping中的路径正确
9. 内存不足
报错信息：
java.lang.OutOfMemoryError: Java heap space
解决：
在IDEA或命令行中加大JVM内存：
java -Xms512m -Xmx1024m -jar your-app.jar
10. 端口被系统保留
报错信息：
BindException: Cannot assign requested address
解决：
Windows上某些端口被系统保留，换一个端口试试。
总结
遇到启动报错不要慌，先看错误信息的第一行，找到真正的异常原因，再对症下药。上面这10种覆盖了日常开发中90%的启动报错场景。
