Spring Boot 2迁移遇依赖兼容问题，求合理应用架构方案

我完全懂你这种头疼的感觉——升级Spring Boot版本本来就够折腾了，还要跟内部Spring依赖的版本兼容问题死磕，每次新版本来都要重复搞一遍，想想都累。咱们来拆解下这个问题，看看怎么优化。

初期逐一适配内部依赖确实是必经的过渡步骤，但长期来看这个方案效率太低，尤其在内部依赖多、迭代快的场景下，问题会越来越突出：

• 重复劳动多：每次Spring Boot版本升级，都要挨个检查所有内部依赖的兼容情况，耗时耗力
• 风险高：容易遗漏某些依赖的细节，导致线上出现隐藏的配置类失效问题
• 缺乏统一管控：团队协作时很容易出现依赖版本不一致的情况，排查问题更麻烦

1. 搭建内部Spring Boot Starter统一管理（最优解） #

把你们所有内部Spring项目的依赖封装成自定义Starter，在Starter里统一维护与Spring Boot版本的兼容关系。这样做的好处简直是一劳永逸：

• 业务项目只需引入这个自定义Starter，不用关心内部依赖的具体版本，Starter会自动适配当前Spring Boot版本
• 当Spring Boot升级时，只需要在Starter里统一调整所有内部依赖的版本，业务项目直接升级Starter版本即可，无需逐一修改
• 还能在Starter里封装通用的配置类、自动配置逻辑，避免业务项目重复写冗余代码

举个简单的pom配置例子，你的自定义Starter可以这么写：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version> <!-- 绑定对应的Spring Boot版本 -->
    <relativePath/>
</parent>

<dependencies>
    <!-- 统一引入所有内部Spring项目依赖，并管控版本 -->
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>internal-spring-service-a</artifactId>
        <version>1.2.0</version> <!-- 适配Spring Boot 2.7的版本 -->
    </dependency>
    <dependency>
        <groupId>com.yourcompany</groupId>
        <artifactId>internal-spring-service-b</artifactId>
        <version>3.1.0</version>
    </dependency>
</dependencies>

2. 用Spring Boot依赖管理统一管控 #

如果暂时没法做自定义Starter，可以在项目的父pom里引入Spring Boot的dependencyManagement，把所有内部依赖的版本统一配置在这里，和Spring Boot版本做绑定。这样业务项目里引入内部依赖时就不用写版本号，父pom会自动帮你管控。

示例父pom配置：

<dependencyManagement>
    <dependencies>
        <!-- 引入Spring Boot官方依赖管理 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.15</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- 统一配置内部依赖版本 -->
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>internal-spring-service-a</artifactId>
            <version>1.2.0</version>
        </dependency>
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>internal-spring-service-b</artifactId>
            <version>3.1.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 建立内部依赖版本兼容矩阵 #

维护一份清晰的文档，记录每个内部Spring项目版本对应的Spring Boot支持版本。比如：

这样每次升级Spring Boot时，直接查这个矩阵就能知道该用哪个版本的内部依赖，减少试错成本。还可以把这个矩阵集成到CI/CD流程里，自动检查依赖版本是否兼容，提前规避问题。

4. 推动内部依赖项目遵循Spring Boot版本规范 #

如果内部Spring项目由不同团队维护，可以推动大家对齐Spring Boot的版本规范：

• 内部依赖项目也使用Spring Boot Starter Parent作为父pom，保持版本对齐
• 每次Spring Boot发布新版本后，内部依赖团队同步更新自己的项目，发布兼容版本
• 给内部依赖添加Spring Boot版本兼容的测试用例，确保版本升级后不会出现配置类失效的问题

逐一迁移的方案在初期过渡阶段是可行的，但长期来看必须建立统一的版本管理机制，自定义Starter是最优解，其次是依赖管理统一管控。另外，内部团队的协作规范也很重要，从根源上减少版本兼容问题。

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