Spring Boot从2.0.5.RELEASE升级至2.7.8及依赖排障求助

核心问题根源 #

Spring Boot与Spring Cloud存在严格的版本绑定关系，直接升级Boot版本而未同步调整Cloud版本必然导致依赖冲突与自动配置异常：

• Spring Boot 2.0.5.RELEASE 对应 Spring Cloud Finchley 系列
• Spring Boot 2.7.8 对应 Spring Cloud 2021.0.x（Jubilee） 系列

分步解决方案 #

1. 同步Spring Cloud版本 #

在pom.xml的dependencyManagement中更新Spring Cloud依赖版本，统一使用与Boot 2.7.8匹配的稳定版：

<dependencyManagement>
    <dependencies>
        <!-- 替换原Spring Cloud依赖版本 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2021.0.5</version> <!-- 2021.0系列稳定版，适配Boot 2.7.x -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2. 修复自动配置错误 #

自动配置异常多由旧版配置类被移除/重命名、依赖类变更导致：

• 定位报错中的NoClassDefFoundError/BeanCreationException，确认废弃的自动配置类
• 移除项目中已淘汰的starter依赖（比如spring-cloud-starter-netflix-zuul，需替换为spring-cloud-starter-gateway）
• 若需禁用特定自动配置，在启动类添加exclude：

@SpringBootApplication(exclude = {DeprecatedAutoConfiguration.class})
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

3. 排查并解决依赖冲突 #

• 执行Maven命令生成依赖树，定位冲突jar包：

mvn dependency:tree

• 在dependencyManagement中统一指定冲突依赖的版本，强制使用Spring Boot 2.7.8管控的版本
• 移除pom中手动指定的与Spring Boot parent重复的依赖版本，让parent自动管理版本一致性

4. 适配其他依赖与代码变更 #

• 检查第三方starter（如MyBatis、Redis等）是否兼容Boot 2.7.x，同步升级对应starter版本
• 替换代码中已废弃的API：比如WebSecurityConfigurerAdapter已移除，需改用SecurityFilterChain实现安全配置
• 修正配置文件中的废弃项：例如server.context-path需改为server.servlet.context-path

内容的提问来源于stack exchange，提问作者Rachit07