SpringBoot自动配置原理新手最容易踩的坑怎么避免

轻墨姑娘_6254

轻墨姑娘_6254

2026-08-07

121人浏览

原创

nosuchbeandefinitionexception主因是自动配置抢占bean注册时机:①@componetscan范围过大误扫autoconfigure包;②@conditionalonmissingbean使自动配置优先创建bean,导致自定义@bean被忽略;③缺少对应starter依赖,autoconfiguration类根本未加载。

springboot自动配置原理新手最容易踩的坑怎么避免

刚写完一个SpringBoot项目,启动时报NoSuchBeanDefinitionException,控制台明明打印了@Bean创建日志,但@Autowired却找不到——这不是代码写错了,而是自动配置的条件判断在你没注意时悄悄接管了Bean生命周期。

搞清自动配置加载顺序,别让@Bean被“先手”覆盖

第一步:确认你的@Configuration类是否被@ComponentScan扫到,且扫描路径不包含spring-boot-autoconfigure包(如org.springframework.boot.autoconfigure)。如果@ComponentScan("com.example")写成@ComponentScan("com"),就会误扫自动配置类,引发类加载冲突或重复注册。

第二步:检查你的@Bean方法是否被@ConditionalOnMissingBean(DataSource.class)这类注解的自动配置类抢先占位。SpringBoot的DataSourceAutoConfiguration默认在用户@Bean之前执行,一旦它已创建了DataSource实例,你的@Bean即使存在也不会注册进容器——【@Bean方法必须早于自动配置类触发,否则会被忽略】

第三步:用@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})临时排除干扰项,验证是否是自动配置抢跑了。这一步能快速定位问题根源,不是最终方案,但能帮你把“Bean消失”从玄学拉回可控范围。

配置属性没生效?先看它有没有被更高优先级的配置覆盖

方法一:检查application.yml中spring.datasource.hikari.maximum-pool-size是否被spring.jpa.properties.hikari.maximum-pool-size覆盖。HibernateJpaAutoConfiguration会读取spring.jpa.properties.hikari.*前缀的配置,并优先应用——【只要spring.jpa.properties.hikari.*存在任意一项,spring.datasource.hikari.*全失效】

Quivr
Quivr

Quivr是一款面向客服团队的 AI 自动回复和工单处理工具。

下载

方法二:启用DEBUG日志,加logging.level.org.springframework.boot.autoconfigure=DEBUG。启动时搜索“Condition evaluated as true”和“Condition evaluated as false”,直接看到哪个@ConditionalOnProperty(name="spring.datasource.url")因缺配置而跳过,比猜快十倍。

方法三:访问/actuator/conditions端点(需引入spring-boot-starter-actuator),页面会列出所有自动配置类的评估结果,绿色✔代表生效,红色✘代表被跳过,点击展开能看到具体哪条条件不满足。

依赖引错导致自动配置根本没加载

如果你期望RedisTemplate自动装配,但启动后连RedisConnectionFactory都没出现,先执行mvn dependency:tree -Dincludes=org.springframework.boot:spring-boot-starter-data-redis。如果输出为空,说明starter根本没引入——自动配置不会凭空发生,【没有starter,就没有对应的AutoConfiguration类被扫描】

常见陷阱:只加了spring-boot-starter-web,却忘了spring-boot-starter-data-jdbc。后者才是触发DataSourceAutoConfiguration的关键依赖;缺它,哪怕application.yml写了spring.datasource.url,自动配置也会静默跳过。

这一步操作起来很简单,直接把文件拖进去就行。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2091

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

377

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

0

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

0

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

20

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Redis6入门到精通超详细教程
Redis6入门到精通超详细教程

共47课时 | 7万人学习