SpringBoot项目启动失败的常见错误总结

 更新时间:2025年11月10日 08:28:01   作者:程序员1970  
文章总结了SpringBoot项目启动失败的常见错误及其解决方法,涵盖了项目识别与依赖问题、配置文件问题、环境配置问题、依赖与Bean注入问题、数据库连接问题、启动类问题以及其他常见问题,需要的朋友可以参考下

一、项目识别与依赖问题

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

报错内容

没有启动的三角按钮
项目结构缺少 Maven Dependencies

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

2. 依赖未下载或下载失败

报错内容

Could not resolve dependencies
pom.xml 文件出现红色下划线

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

二、配置文件问题

1. 配置文件编码错误(YAML)

报错内容

Caused by: org.yaml.snakeyaml.error.YAMLException: java.nio.charset.MalformedInputException: Input length = 2

原因:application.yml文件编码不是UTF-8

2. 配置文件格式错误

报错内容

Failed to load application context
Caused by: org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with name 'org.springframework.boot.autoconfigure.internalCachingMetadataReaderFactory' defined in null: Could not resolve placeholder 'spring.application.name' in value "${spring.application.name}"

原因:YAML文件缩进不正确或格式错误

三、环境配置问题

1. JDK版本不匹配

报错内容

Error: A JNI error has occurred, please check your installation and try again
Invalid maximum heap size: -Xmx512m
The specified size exceeds the maximum representable size.

原因:使用的JDK版本与Spring Boot版本不匹配

  • Spring Boot 3.x默认要求JDK 17+
  • 17以下版本不支持

2. 端口被占用

报错内容

*************************** APPLICATION FAILED TO START ***************************
Description: The Tomcat connector configured to listen on port 8080 failed to start. The port may already be in use or the connector may be misconfigured.
Action: Verify the connector's configuration, identify and stop any process that's listening on port 8080, or configure this application to listen on another port.

原因:8080端口被其他进程占用

四、依赖与Bean注入问题

1. 依赖冲突

报错内容

Exception in thread "main" java.lang.NoSuchMethodError: org.springframework.core.annotation.AnnotationUtils.isCandidateClass(Ljava/lang/Class;Ljava/lang/Class;)Z

原因:不同依赖之间存在版本冲突

2. 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.

原因

  • 未添加@Component、@Service等注解
  • 扫描路径不正确

3. Mapper扫描问题

报错内容

Field clustersDetailsAmqMapper in com.ruoyi.clusters.service.impl.ClustersDetailsAmqServiceImpl required a bean of type 'com.ruoyi.clusters.mapper.ClustersDetailsAmqMapper' that could not be found.

原因:启动类未配置正确的Mapper扫描路径

五、数据库连接问题

1. 数据源配置缺失

报错内容

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

原因:数据库配置缺失(如spring.datasource.url等)

2. 数据库连接失败

报错内容

Unable to connect to database

原因

  • 数据库服务未启动
  • 数据库用户名或密码错误
  • 数据库URL配置错误

六、启动类问题

1. 启动类配置错误

报错内容

找不到主类

原因

  • 启动类未正确标注@SpringBootApplication注解
  • IDE运行配置主类路径错误
  • 项目结构不正确

七、其他常见问题

1. 中文乱码问题

报错内容

java.lang.IllegalArgumentException: Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC 3986

原因:编码格式不一致

2. 依赖版本不匹配

报错内容

The following dependencies have a problem:
- spring-boot-starter-web: 2.4.3
- spring-cloud-starter-eureka: 2.2.12

原因:Spring Boot与Eureka等依赖版本不匹配

到此这篇关于SpringBoot项目启动失败的常见错误总结的文章就介绍到这了,更多相关SpringBoot项目启动失败内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot+Redis BitMap实现签到与统计的项目实践

    SpringBoot+Redis BitMap实现签到与统计的项目实践

    最近项目里需要集成签到和统计功能,连续签到后会给用户发放一些优惠券和奖品,以此来吸引用户持续在该品台进行活跃,本文就详细的介绍一下如何实现,感兴趣的可以了解一下
    2023-09-09
  • java自动生成接口文档完整代码示例

    java自动生成接口文档完整代码示例

    在软件开发中,编写接口文档是一项必要但繁琐的任务,为了简化这一过程,可以通过使用Swagger2和Swagger-UI来自动生成接口文档,这篇文章主要介绍了java自动生成接口文档的相关资料,需要的朋友可以参考下
    2021-07-07
  • java实现LFU算法的示例代码

    java实现LFU算法的示例代码

    LFU(Least Frequently Used)算法根据数据的历史访问频率来淘汰数据,其核心思想是“如果数据过去被访问多次,那么将来被访问的频率也更高”,本文为大家整理了Java实现LFU算法的示例代码,需要的可以参考下
    2023-11-11
  • 代码详解Java猴子选王问题(约瑟夫环)

    代码详解Java猴子选王问题(约瑟夫环)

    本篇文章通过实例给大家分析了java约瑟夫环这个经典内容,有兴趣的跟着小编一起学习下吧。
    2018-02-02
  • 实例解析Java设计模式编程中的适配器模式使用

    实例解析Java设计模式编程中的适配器模式使用

    适配器模式的主要作用是在新接口和老接口之间进行适配,通过将一个类的接口转换成客户期望的另一个接口,让原本不兼容的接口可以合作无间,本文以实例解析Java设计模式编程中的适配器模式使用,需要的朋友可以参考下
    2016-05-05
  • Jmeter非GUI模式运行分布式测试

    Jmeter非GUI模式运行分布式测试

    这篇文章主要介绍了Jmeter非GUI模式运行分布式测试,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-10-10
  • Mybatis-Plus批量添加或修改数据的3种方式总结

    Mybatis-Plus批量添加或修改数据的3种方式总结

    使用Mybatis-plus可以很方便的实现批量新增和批量修改,不仅比自己写foreach遍历方便很多,而且性能也更加优秀,下面这篇文章主要给大家介绍了关于Mybatis-Plus批量添加或修改数据的3种方式,需要的朋友可以参考下
    2023-05-05
  • Java中的equsals和==

    Java中的equsals和==

    这篇文章主要介绍了Java中的equsals和==的相关内容,感兴趣的朋朋友可以参考下文
    2021-08-08
  • Java国密加密SM2代码详细使用步骤

    Java国密加密SM2代码详细使用步骤

    SM2算法可以用较少的计算能力提供比RSA算法更高的安全强度,而所需的密钥长度却远比RSA算法低,下面这篇文章主要给大家介绍了关于Java国密加密SM2代码的相关资料,需要的朋友可以参考下
    2024-07-07
  • spring cloud学习入门之config配置教程

    spring cloud学习入门之config配置教程

    这篇文章主要给大家介绍了关于spring cloud学习入门之config配置的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用spring cloud具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2017-09-09

最新评论