讲师中心 微信公众号
AI工具推荐 视频效率加速

SpringBoot 3.x自动配置原理和2.x比起来变化在哪里

阿雪同学_4911

阿雪同学_4911

发布时间:2026-08-07 16:45:26

|

194人浏览过

|

来源于php中文网

原创

Spring Boot 3.x自动配置原理与2.x差异核心在于四点:入口机制改用AutoConfigurationGroup延迟加载;配置类加载路径从spring.factories切换为AutoConfiguration.imports纯文本文件;条件评估更严格,如@ConditionalOnClass不触发静态初始化、@ConditionalOnMissingBean默认仅查当前容器;全面迁移至jakarta.*包并引入@AutoConfiguration新注解标准。

springboot 3.x自动配置原理和2.x比起来变化在哪里

要准确理解SpringBoot 3.x自动配置原理与2.x的差异,必须从入口机制、配置类加载路径、条件评估逻辑和底层依赖四方面切入,否则升级后启动失败或Bean缺失将难以定位。

自动配置的触发入口变了

Spring Boot 2.x中@EnableAutoConfiguration通过@Import(AutoConfigurationImportSelector.class)导入配置类;Spring Boot 3.x则改用@Import(AutoConfigurationGroup.class),该类实现了DeferredImportSelector.Group接口,延迟到所有@Configuration类解析完成后再执行分组筛选。

这一步变化导致自动配置类的加载时机整体后移,避免了早期因@Configuration未就绪而误判@ConditionalOnClass等条件的问题。

如果你在2.x中自定义过AutoConfigurationImportSelector的子类,【必须重写为AutoConfigurationGroup实现】,否则不会被识别。

配置类不再从spring.factories加载

方法一:Spring Boot 2.x依赖META-INF/spring.factories文件,以org.springframework.boot.autoconfigure.EnableAutoConfiguration为key列出全限定类名。

方法二:Spring Boot 3.x完全弃用spring.factories,改用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件,每行一个自动配置类的全限定名,不支持#注释、不支持逗号分隔、不支持通配符。

这个文件必须是纯文本格式,UTF-8编码,且首行不能有BOM头。如果旧项目保留了spring.factories但没删掉,3.x会静默忽略它——不会报错,也不会加载其中的配置类,极易造成功能丢失却查不到原因。

条件注解的评估逻辑更严格

第一步:@ConditionalOnClass现在使用ClassLoader.loadClass而非Class.forName,不触发静态初始化块。

第二步:@ConditionalOnMissingBean默认启用search = SearchStrategy.CURRENT(仅当前容器),而2.x默认是ALL(含父容器)。这意味着父子上下文隔离更彻底,跨上下文共享Bean需显式指定search = SearchStrategy.ALL。

第三步:@ConditionalOnProperty对空字符串、null值、未定义属性的判定更精确,例如spring.profiles.active=“”在2.x中可能被当作激活default,在3.x中明确视为未激活任何profile。

Jakarta EE迁移直接影响自动配置生效

Spring Boot 3.x所有自动配置类内部使用的Servlet、Validation、Persistence等API均已切换为jakarta.*包。例如:AutoConfigureWebMvc中的WebMvcConfigurer依赖jakarta.servlet.Filter,若项目里仍有javax.servlet.http.HttpServletRequest参数的自定义Filter,【该Filter会导致整个WebMvcAutoConfiguration跳过】,因为@ConditionalOnClass(jakarta.servlet.Filter.class)为true,但@ConditionalOnMissingBean类型匹配失败。

这并非配置错误,而是类路径污染引发的条件误判——必须确保所有依赖jar中不混用javax.*和jakarta.*的同一接口。

@AutoConfiguration注解成为新标准

方法1:Spring Boot 3.x推荐使用@AutoConfiguration替代@EnableAutoConfiguration作为配置类顶层注解,它自带@Import(AutoConfigurationImportRegistrar.class),可声明order、before、after等元数据。

方法2:@AutoConfiguration可直接标注在普通类上,无需配合@Configuration;而2.x中所有自动配置类都必须是@Configuration类。

方法3:Spring Boot 3.x内置的自动配置类(如DataSourceAutoConfiguration)已全部重构为@AutoConfiguration风格,源码中不再出现@EnableAutoConfiguration。

你写的自定义starter若仍用@EnableAutoConfiguration + @Configuration组合,在3.x中虽能运行,但无法参与新的排序和前置/后置依赖声明机制。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

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

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

2111

2025.08.06

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

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

397

2026.01.26

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

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

20

2026.09.21

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

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

0

2026.09.21

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

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

0

2026.09.21

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

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

0

2026.09.21

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

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

0

2026.09.21

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

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

40

2026.09.20

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

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

0

2026.09.20

热门下载

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

精品课程

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

共47课时 | 7.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn