SpringBoot自动配置条件优先级是什么

浅浩酱_5883

浅浩酱_5883

2026-08-07

773人浏览

原创

springboot自动配置条件优先级由条件注解的与逻辑和配置类加载顺序共同决定:多个条件注解必须全部满足才加载配置类;加载顺序则通过@autoconfigurebefore/after、@order或字典序控制,影响@conditionalonbean等依赖容器状态的条件判断。

springboot自动配置条件优先级是什么

SpringBoot自动配置条件优先级决定哪些配置类能被加载、哪些被跳过,直接影响Bean是否注册成功。当多个条件注解共存于一个配置类上时,必须全部满足才进入注册流程;而不同配置类之间的生效顺序,则由加载先后决定,这直接关系到@ConditionalOnBean或@ConditionalOnMissingBean能否正确判断容器状态。

条件注解本身的执行优先级

条件注解没有“高低优先级”之分,它们是与逻辑(AND)关系:一个配置类上同时标注了@ConditionalOnClass、@ConditionalOnMissingBean、@ConditionalOnProperty,三者必须全部返回true,该配置类才会被加载。

任意一个条件失败,整个配置类被跳过,不会进入Bean注册阶段。

例如:@ConditionalOnClass(DataSource.class) && @ConditionalOnMissingBean(DataSource.class) 同时存在,意味着——仅当项目类路径有DataSource类 且 容器中尚未存在DataSource类型的Bean时,该自动配置才生效。

配置类加载顺序的优先级规则

真正影响“谁先谁后”的是配置类的加载顺序,它决定了条件判断的上下文是否就绪。

第一步:Spring Boot启动时,所有候选自动配置类(来自META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports)被读入内存。

第二步:按以下规则排序:

① 显式声明优先:@AutoConfigureBefore(XxxAutoConfiguration.class) 的类排在Xxx之前;@AutoConfigureAfter(YyyAutoConfiguration.class) 的类排在Yyy之后。

② 数值顺序优先:实现Ordered接口或标注@Order(value = -100)的类,数值越小越靠前。

③ 默认顺序:若无显式声明,则按全限定类名字典序排列(如A开头的类早于Z开头的类)。

剪映专业版
剪映专业版

剪映专业版是一款面向短视频和专业创作场景的 AI 视频剪辑工具。

下载

【关键点】 若A类依赖B类中的Bean(即A含@ConditionalOnBean(B.class)),但排序导致A在B之前加载,则B尚未注册,条件不成立,A被跳过——此时必须用@AutoConfigureAfter(B.class)强制A后于B加载。

用户配置覆盖自动配置的优先级

这不是条件注解层面的优先级,而是配置源层级的覆盖能力。

方法一:通过application.properties/yml设置属性,可覆盖自动配置类中@EnableConfigurationProperties绑定的参数。例如spring.datasource.hikari.maximum-pool-size=20会覆盖HikariDataSourceAutoConfiguration的默认值。

方法二:显式定义@Bean。只要@Bean方法所在配置类被Spring扫描到,且其类型与自动配置试图创建的Bean类型一致,@ConditionalOnMissingBean就会失效——因为条件不满足,自动配置类直接跳过。

注意:自定义@Bean必须确保其配置类比对应自动配置类更早加载,否则自动配置已抢先注册Bean,你的@Bean会被忽略(除非指定primary=true并配合@Qualifier使用)。

条件评估发生的两个阶段

条件判断不是只做一次,而是分两轮执行:

第一轮在parse_configuration阶段:检查@ConditionalOnClass、@ConditionalOnResource、@ConditionalOnProperty等基于环境/类路径/配置文件的条件。此时容器尚未初始化,无法感知已注册的Bean。

第二轮在register_bean阶段:检查@ConditionalOnBean、@ConditionalOnMissingBean、@ConditionalOnSingleCandidate等依赖容器状态的条件。此时ApplicationContext已部分构建,BeanFactory可用。

这意味着:@ConditionalOnClass在启动极早期就筛掉一批配置类;而@ConditionalOnMissingBean必须等到其他配置类完成Bean注册后才能准确判断——所以它的结果高度依赖加载顺序。

相关文章

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

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

下载

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

相关专题

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

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

2025.08.06

2171

22

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

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

2026.01.26

417

25

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

60

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

20

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

20

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

20

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

20

19

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

2026.09.22

20

19

热门下载

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

精品课程

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

共47课时 | 7.1万人学习