必须处理类路径扫描机制、依赖兼容性、包名迁移和配置绑定方式四类变更：2.7用spring.factories，3.0改用autoconfiguration.imports文件；javax.全部替换为jakarta.；@configurationproperties推荐构造函数绑定；exclude自动配置需严格校验类名，拼错将静默失效。
要让Spring Boot 2.7项目平稳升级到3.0并确保自动配置正常生效，必须处理好类路径扫描机制、依赖兼容性、包名迁移和配置绑定方式这四类根本性变更。
自动配置类加载路径彻底更换
Spring Boot 2.7及之前版本从META-INF/spring.factories文件读取自动配置类列表，而3.0起废弃该机制，改用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，且内容为每行一个全限定类名。
第一步：检查项目中所有自定义starter的spring.factories文件；
第二步：将其中org.springframework.boot.autoconfigure.EnableAutoConfiguration=开头的键值对，全部迁移到新路径下的AutoConfiguration.imports文件中；
第三步：删除原spring.factories中该行——【保留它会导致2.7兼容模式被激活，但3.0启动时会报WARN甚至忽略部分配置】；
第四步：确认新文件无BOM头、换行符为LF、每行仅含一个类全名，末尾不加逗号或空格。
javax → jakarta 包名强制替换
Spring Boot 3.0底层基于Spring Framework 6，全面切换至Jakarta EE 9+规范，所有javax.*包均不可用。
方法一：全局搜索替换javax.servlet→jakarta.servlet、javax.persistence→jakarta.persistence、javax.validation→jakarta.validation；
方法二：使用Maven插件自动转换（适用于遗留代码量大场景）：
在pom.xml中添加jakarta-transformer-maven-plugin，执行mvn jakarta:transform；
【Hibernate 6默认不再识别@javax.persistence.Entity，未替换将导致实体类无法注册为JPA Bean】
@ConfigurationProperties绑定方式重构
Spring Boot 3.0推荐构造函数绑定替代setter绑定，提升不可变性和类型安全性。
旧写法（2.7兼容但不推荐）：
@ConfigurationProperties(prefix = "app")<br>public class AppProps { private String name; public void setName(String name) { this.name = name; } }
新写法（3.0首选）：
@ConfigurationProperties(prefix = "app")<br>public record AppProps(String name) {}
注意：若仍用class形式，必须显式声明@ConstructorBinding注解，并确保所有属性在构造函数中传入；否则启动时报Failed to bind properties to …异常。
排除自动配置的语法保持一致但行为更严格
两种版本都支持@EnableAutoConfiguration(exclude = XxAutoConfiguration.class)，但3.0对excludeName校验更严。
直接写类名即可，例如排除数据源自动配置：@EnableAutoConfiguration(exclude = DataSourceAutoConfiguration.class)
若用字符串排除（如测试环境临时关闭安全配置），必须写完整类名：excludeName = "org.springframework.boot.autoconfigure.security.servlet.SecurityAutoConfiguration"
这一步操作起来很简单，直接把类名复制进exclude参数就行。但要注意：3.0中拼错类名不会报错，而是静默跳过——【结果是本该禁用的自动配置仍在生效，极易引发线上安全漏洞】。
