APP正在开发中...
返回顶部
您的位置： 主页 > 软件编程 > java >

收藏
分享到

SpringBoot启动报错的11个高频问题排查与解决终极指南

java 来源：互联网 作者：佚名 发布时间：2025-03-30 10:13:08 人浏览
摘要

1. 依赖冲突：NoSuchMethodError 的终极解法 错误现象： java.lang.NoSuchMethodError: org.springframework.core.annotation.AnnotationUtils.isAnnotationInherited 原因分析： 不同版本的Spring组件冲突（如同时存在Spring Boot

1. 依赖冲突：NoSuchMethodError 的终极解法

错误现象：

java.lang.NoSuchMethodError: org.springframework.core.annotation.AnnotationUtils.isAnnotationInherited  

原因分析：

不同版本的Spring组件冲突（如同时存在Spring Boot 2.3和2.5的依赖）。

解决方案：

Maven项目：运行依赖树分析命令定位冲突：

1

mvn dependency:tree -Dverbose | grep conflict 

Gradle项目：执行依赖报告：

1

gradle dependencies > dep.txt 

在pom.xml或build.gradle中显式声明版本号，使用<exclusions>排除旧依赖。

防坑技巧：

使用IDE插件（如IntelliJ的Maven Helper、VS Code的Gradle Lens）可视化分析依赖树。

2. Bean注入失败：No qualifying bean of type 如何破？

错误现象：

No qualifying bean of type 'com.example.UserService' available  

原因分析：

  • 未添加@Component、@Service等注解。
  • 包路径未被@ComponentScan扫描到。
  • Bean的作用域配置错误（如@Scope("prototype")导致延迟初始化）。

解决方案：

  • 检查类是否添加了Spring注解。
  • 确保主类所在包包含所有Bean的路径（或手动指定@ComponentScan）。
  • 使用@Autowired(required = false)避免强制注入。

代码示例：

1

2

3

@SpringBootApplication 

@ComponentScan(basePackages = "com.example") // 显式指定扫描路径 

public class Application { ... } 

3. 端口占用：Port 8080 already in use 的3种解决方案

错误现象：

WebServerException: Unable to start embedded Tomcat (Port 8080 already in use)  

解决方案：

终止占用进程：

1

2

3

4

# Linux/Mac 

lsof -i :8080 && kill -9 <PID> 

# Windows 

netstat -ano | findstr 8080 && taskkill /F /PID <PID> 

修改应用端口：

1

2

3

# application.yml 

server: 

  port: 8081 

随机端口（适合测试环境）：

1

2

server: 

  port: 0 

4. 配置文件加载失败：application.yml 为何不生效？

错误现象：

配置属性未生效，日志无报错。

原因分析：

  • 文件名错误（如application.yaml拼写错误）。
  • 文件未放在src/main/resources目录下。
  • YAML语法错误（如缩进不一致）。

解决方案：

  • 检查文件名和路径是否符合Spring Boot规范。
  • 使用YAML校验工具（如在线YAML Parser）验证语法。

开启配置属性调试：

1

2

3

logging: 

  level: 

    org.springframework.boot.context.properties: TRACE 

5. 数据库连接池报错：HikariPool-1 - Exception during pool initialization

错误现象：

HikariPool-1 - Exception during pool initialization: Connection refused  

原因分析：

数据库URL、用户名或密码错误。

数据库服务未启动。

连接池配置超时时间过短。

解决方案：

检查application.yml中的数据库配置：

1

2

3

4

5

spring: 

  datasource: 

    url: jdbc:mysql://localhost:3306/mydb?useSSL=false 

    username: root 

    password: root 

增加连接池超时时间：

1

2

3

4

spring: 

  datasource: 

    hikari: 

      connection-timeout: 30000 

6. 主类缺失：Unable to find main class 的隐藏原因

错误现象：

Error: Unable to find or load main class com.example.Application  

解决方案：

Maven项目：检查pom.xml中是否配置了主类：

1

2

3

<properties> 

    <start-class>com.example.Application</start-class> 

</properties> 

Gradle项目：在build.gradle中指定主类：

1

2

3

springBoot { 

    mainClass = 'com.example.Application' 

} 

重新生成IDE项目文件（如执行mvn idea:idea或gradle idea）。

7. 循环依赖：Requested bean is currently in creation

错误现象：

BeanCurrentlyInCreationException: Error creating bean with name 'A'  

解决方案：

优先使用构造器注入：避免字段注入导致循环依赖。

延迟加载：在其中一个Bean上添加@Lazy注解。

终极方案：重构代码，提取公共逻辑到第三方类。

代码示例：

1

2

3

4

5

6

7

@Service 

public class ServiceA { 

    private final ServiceB serviceB; 

    public ServiceA(@Lazy ServiceB serviceB) { 

        this.serviceB = serviceB; 

    } 

} 

8. JAR包冲突：ClassNotFoundException 的精准定位法

错误现象：

java.lang.ClassNotFoundException: org.apache.commons.lang3.StringUtils 

解决方案：

检查依赖是否缺失：

1

2

3

4

5

6

<!-- Maven示例 --> 

<dependency> 

    <groupId>org.apache.commons</groupId> 

    <artifactId>commons-lang3</artifactId> 

    <version>3.12.0</version> 

</dependency> 

使用mvn clean install -U强制更新依赖。

检查是否有<scope>provided</scope>错误配置。

9. 缓存配置错误：RedisConnectionFailureException 快速修复

错误现象：

RedisConnectionFailureException: Unable to connect to Redis 

解决方案：

检查Redis服务是否启动：

1

redis-cli ping  # 返回PONG表示正常 

确认配置文件中的Redis连接信息：

1

2

3

4

5

spring: 

  redis: 

    host: localhost 

    port: 6379 

    password: 123456 

10. 版本不兼容：Spring Boot与第三方库的版本地狱

防坑技巧：

使用Spring Boot官方提供的依赖管理：

1

2

3

4

5

6

7

8

9

10

11

<dependencyManagement> 

    <dependencies> 

        <dependency> 

            <groupId>org.springframework.boot</groupId> 

            <artifactId>spring-boot-dependencies</artifactId> 

            <version>3.1.0</version> 

            <type>pom</type> 

            <scope>import</scope> 

        </dependency> 

    </dependencies> 

</dependencyManagement> 

11. 静态资源加载失败：Whitelabel Error Page 的深层原因

错误现象：

访问静态资源（如HTML、JS）时返回Spring Boot默认错误页。

原因分析：

静态资源未放在src/main/resources/static或public目录。

自定义拦截器（如Spring Security）拦截了静态请求。

未配置欢迎页（index.html优先级低于控制器路由）。

解决方案：

检查资源路径是否符合规范：

src/main/resources/  
├── static/  
│   └── index.html  
└── public/  
    └── logo.png  

若使用Spring Security，放行静态资源：

1

2

3

4

5

6

7

8

@Configuration 

public class SecurityConfig extends WebSecurityConfigurerAdapter { 

    @Override 

    protected void configure(HttpSecurity http) throws Exception { 

        http.authorizeRequests() 

            .antMatchers("/static/**", "/public/**").permitAll(); 

    } 

} 

防坑技巧：

优先使用classpath:/static/存放资源，避免路径混淆。

12. Profile配置错误：No active profile set 怎么办？

错误现象：

No active profile set, falling back to default profiles: default  

原因分析：

未通过启动参数、环境变量或配置文件激活Profile。

application-{profile}.yml文件命名错误。

解决方案：

命令行激活：

1

java -jar app.jar --spring.profiles.active=prod 

环境变量激活：

1

export SPRING_PROFILES_ACTIVE=dev && java -jar app.jar 

配置文件硬编码（不推荐生产环境）：

1

2

3

4

# application.yml 

spring: 

  profiles: 

    active: dev 

防坑技巧：

生产环境禁止在配置文件中硬编码active，推荐使用外部化配置（如Kubernetes ConfigMap）。

13. AOP代理问题：BeanNotOfRequiredTypeException 的坑

错误现象：

BeanNotOfRequiredTypeException: Bean named 'userService' is expected to be of type 'com.example.UserService' but was actually of type 'jdk.proxy2.$Proxy123'  

原因分析：

JDK动态代理生成的代理类与原始类类型不兼容。

目标类未实现接口，但强制使用了JDK代理。

解决方案：

强制使用CGLIB代理（修改配置）：

1

2

3

4

# application.yml 

spring: 

  aop: 

    proxy-target-class: true 

目标类实现一个空接口（兼容JDK代理）。

代码示例：

1

2

3

4

public interface UserServiceInterface {} 

  

@Service 

public class UserService implements UserServiceInterface { ... } 

14. 日志冲突：SLF4J绑定多个实现

错误现象：

SLF4J: Class path contains multiple SLF4J bindings.  
SLF4J: Found binding in [jar:file:/.../logback-classic.jar!/org/slf4j/impl/StaticLoggerBinder.class]  
SLF4J: Found binding in [jar:file:/.../slf4j-log4j12.jar!/org/slf4j/impl/StaticLoggerBinder.class]  

解决方案：

Maven排除冲突依赖：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

<dependency> 

    <groupId>org.springframework.boot</groupId> 

    <artifactId>spring-boot-starter-web</artifactId> 

    <exclusions> 

        <exclusion> 

            <groupId>org.springframework.boot</groupId> 

            <artifactId>spring-boot-starter-logging</artifactId> 

        </exclusion> 

    </exclusions> 

</dependency> 

<dependency> 

    <groupId>org.springframework.boot</groupId> 

    <artifactId>spring-boot-starter-log4j2</artifactId> 

</dependency> 

Gradle排除冲突：

1

2

3

configurations.all { 

    exclude group: 'org.springframework.boot', module: 'spring-boot-starter-logging' 

} 

15. 内存溢出：java.lang.OutOfMemoryError 的紧急处理

错误现象：

1

2

3

java.lang.OutOfMemoryError: Java heap space 

// 或 

java.lang.OutOfMemoryError: Metaspace 

紧急处理：

临时扩容：调整JVM参数（示例为堆内存和元空间）：

1

java -Xmx1024m -Xms512m -XX:MaxMetaspaceSize=256m -jar app.jar 

内存分析：

使用jmap生成堆转储：

1

jmap -dump:format=b,file=heapdump.hprof <PID> 

使用VisualVM或Eclipse MAT分析内存泄漏。

防坑技巧：

定期监控生产环境内存使用（如Prometheus + Grafana）。

16. 第三方库兼容性：Jackson 序列化报错的秘密

错误现象：

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: No serializer found for class com.example.User  

解决方案：

为实体类添加@Getter/@Setter（Lombok）或手动实现getter方法。

忽略未知字段（全局配置）：

1

2

3

4

5

spring: 

  jackson: 

    default-property-inclusion: non_null 

    deserialization: 

      FAIL_ON_UNKNOWN_PROPERTIES: false 

若使用record类，添加@JsonAutoDetect注解：

1

2

@JsonAutoDetect(fieldVisibility = JsonAutoDetect.Visibility.ANY) 

public record User(String name) {} 

17. 安全配置错误：Spring Security 的常见拦截问题

错误现象：

请求被拦截返回403 Forbidden或跳转到登录页。

解决方案：

放行公开资源路径：

1

2

3

4

5

6

7

8

@Override 

protected void configure(HttpSecurity http) throws Exception { 

    http.authorizeRequests() 

        .antMatchers("/", "/login", "/css/**").permitAll() 

        .anyRequest().authenticated() 

        .and() 

        .formLogin(); 

} 

禁用CSRF（仅限API项目）：

1

http.csrf().disable(); 

防坑技巧：

生产环境必须启用CSRF保护，仅对无状态API服务可禁用。

18. 异步线程池配置：@Async 注解失效的排查

错误现象：

@Async方法同步执行，未触发异步线程。

解决方案：

启用异步支持（主类添加注解）：

1

2

3

@SpringBootApplication 

@EnableAsync // 关键注解 

public class Application { ... } 

自定义线程池（避免默认线程池阻塞）：

1

2

3

4

5

6

7

8

9

10

11

12

@Configuration 

public class AsyncConfig { 

    @Bean("taskExecutor") 

    public Executor taskExecutor() { 

        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor(); 

        executor.setCorePoolSize(10); 

        executor.setMaxPoolSize(20); 

        executor.setQueueCapacity(200); 

        executor.initialize(); 

        return executor; 

    } 

} 

调用示例：

1

2

@Async("taskExecutor") 

public void asyncProcess() { ... } 

19. 热部署失败：DevTools 不生效的隐藏配置

错误现象：

修改代码后未自动重启。

解决方案：

IDE配置：

  • IntelliJ: Settings → Build → Compiler → Build project automatically
  • Eclipse: 启用Project → Build Automatically

添加DevTools依赖：

1

2

3

4

5

6

<dependency> 

    <groupId>org.springframework.boot</groupId> 

    <artifactId>spring-boot-devtools</artifactId> 

    <scope>runtime</scope> 

    <optional>true</optional> 

</dependency> 

排除静态资源重启（提升速度）：

1

2

3

4

spring: 

  devtools: 

    restart: 

      exclude: static/**,public/** 

20. 玄学报错：日志一片空白时如何自救？

错误现象：

应用启动后无任何日志输出。

解决方案：

检查logback-spring.xml或log4j2.xml是否存在配置错误。

强制指定日志级别：

1

2

3

logging: 

  level: 

    root: INFO 

添加默认日志依赖：

1

2

3

4

<dependency> 

    <groupId>org.springframework.boot</groupId> 

    <artifactId>spring-boot-starter-logging</artifactId> 

</dependency> 

终极防坑指南

原子化验证：每修改一个配置后立即测试，避免多个变更叠加导致问题复杂化。

日志级别控制：遇到问题时将日志级别调整为DEBUG或TRACE：

1

2

3

4

logging: 

  level: 

    root: DEBUG 

    org.springframework: TRACE 

最小化复现：提取核心代码到独立Demo项目，排除无关依赖干扰。
版权声明 : 本文内容来源于互联网或用户自行发布贡献，该文观点仅代表原作者本人。本站仅提供信息存储空间服务和不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权， 违法违规的内容， 请发送邮件至2530232025#qq.cn(#换@)举报，一经查实，本站将立刻删除。

您可能感兴趣的文章 :

原文链接 :
相关文章
  • SpringBoot实现数据库读写分离的3种方法
    一、数据库读写分离概述 在大型应用系统中，随着访问量的增加，数据库常常成为系统的性能瓶颈。为了提高系统的读写性能和可用性，读
  • SpringBoot启动报错的11个高频问题排查与解决终极
    1. 依赖冲突：NoSuchMethodError 的终极解法 错误现象： java.lang.NoSuchMethodError: org.springframework.core.annotation.AnnotationUtils.isAnnotationInherited 原因分析
  • SpringBoot2.6.x与Swagger3兼容问题及解决方法
    报错： Failed to start bean documentationPluginsBootstrapper; nested exception is java.lang.NullPointerException 解决： ? 如果项目中未引入spring-boot-starter-actuator，
  • Java使用多线程处理未知任务数
    知道任务个数，你可以定义好线程数规则，生成线程数去跑 代码说明： 1.虚拟线程池： 使用 Executors.newVirtualThreadPerTaskExecutor() 创建虚拟线程
  • Java高级-反射&动态代理介绍
    1. 反射 1.1 反射的概述 专业的解释（了解一下）： 是在运行状态中，对于任意一个类，都能够知道这个类的所有属性和方法； 对于任意一个
  • 使用EasyPoi实现多Sheet页导出的代码
    因多次遇到导出多Sheet页的需求，故记录下来，以备后续参考使用 一、Pom依赖 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 !-- 集成easypoi组件 .导出excel ht

  • idea导入若依项目教程

    idea导入若依项目教程
    IDEA导入若依管理系统 项目官网地址：https://gitee.com/y_project/RuoYi-Vue 前提 系统需求： JDK = 1.8 MySQL = 5.5 Maven = 3.0 redis 必须启动（可以下载一个

  • Java中实现订单超时自动取消功能(最新推荐)

    Java中实现订单超时自动取消功能(最新推荐)
    在开发中，我们会遇到需要延时任务的业务场景，例如：用户下单之后未在规定的时间内支付成功，该订单会自动取消； 用户注册成功15分
  • 阿里巴巴TransmittableThreadLocal使用介绍
    ThreadLocal在上下文的数据传输上非常的方便和简洁。 工业实践中，比较常用的有三个，ThreadLocal、InheritableThreadLocal、TransmittableThreadLocal，那
  • SpringBoot使用Jackson介绍
    概述 Springboot配置JackSon处理类属性，JavaBean序列化为JSON格式，常用框架：阿里fastjson，谷歌gson、Jackson等。 ① 性能：Jackson Fastjson Gson 同个结
推荐阅读
最新更新
友情链接
  • 本站所有内容来源于互联网或用户自行发布，本站仅提供信息存储空间服务，不拥有版权，不承担法律责任。如有侵犯您的权益，请您联系站长处理！
  • Copyright © 2017-2022 F11.CN All Rights Reserved. F11站长开发者网 版权所有 | 苏ICP备2022031554号-1 | 51LA统计