如何在Gradle中为子依赖指定不同版本？Spring Boot版本冲突问询

问题描述 #

当前build.gradle配置如下：

implementation('org.springframework.boot:3.0.0')
implementation('org.springdoc:springdoc-openapi-ui') //depends on org.springframework.boot:2.7.5 

需求：项目自身使用Spring Boot 3.0.0，同时让springdoc-openapi-ui依赖Spring Boot 2.7.5，询问该方案是否可行，并希望通过Project Jigsaw（Java模块系统）实现具体指导。

可行性说明 #

这种跨版本依赖隔离可行，但需注意：Spring Boot 2.x基于Jakarta EE 8（类包javax.*），3.x基于Jakarta EE 9+（类包jakarta.*），存在类包名差异，必须通过严格的模块边界控制避免类加载冲突。

Project Jigsaw实现步骤 #

1. 项目模块化改造 #

在项目中拆分出两个Java模块：主模块（使用Spring Boot 3.0.0）和springdoc隔离模块（依赖Spring Boot 2.7.5），分别创建module-info.java定义模块边界：

主模块（示例模块名：com.myapp.main）

module com.myapp.main {
    // 声明依赖Spring Boot 3核心模块
    requires spring.boot;
    requires spring.boot.autoconfigure;
    requires spring.boot.starter.web;
    // 若需与隔离模块交互，导出公共API包
    exports com.myapp.api to com.myapp.springdoc.isolation;
}

springdoc隔离模块（示例模块名：com.myapp.springdoc.isolation）

module com.myapp.springdoc.isolation {
    // 声明依赖Spring Boot 2.7.5核心模块与springdoc-openapi-ui
    requires spring.boot;
    requires spring.boot.autoconfigure;
    requires springdoc.openapi.ui;
    // 若主模块需调用springdoc功能，导出对应API包
    exports org.springdoc.core to com.myapp.main;
}

2. Gradle配置调整 #

通过多项目结构分别控制两个模块的依赖版本：

根项目build.gradle

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.0.0' apply false
}

subprojects {
    apply plugin: 'java'
}

主模块build.gradle

plugins {
    id 'org.springframework.boot'
}

dependencies {
    // 主模块使用Spring Boot 3.0.0 BOM统一管理版本
    implementation platform(org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES)
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 依赖springdoc隔离模块
    implementation project(':springdoc-isolation')
}

springdoc隔离模块build.gradle

dependencies {
    // 隔离模块使用Spring Boot 2.7.5 BOM
    implementation platform('org.springframework.boot:spring-boot-dependencies:2.7.5')
    implementation 'org.springframework.boot:spring-boot-starter'
    implementation 'org.springdoc:springdoc-openapi-ui'
}

3. 边界与类加载控制 #

• 两个模块的交互必须通过导出的公共API进行，禁止直接引用对方内部类或未导出的包。
• 隔离模块全程使用Spring Boot 2.x的javax.*类包，主模块使用jakarta.*类包，Java模块系统会自动隔离不同模块的类加载空间，避免冲突。

4. 注意事项 #

• Spring Boot自动配置可能在跨版本隔离中出现冲突，需在隔离模块中单独初始化springdoc配置，或在主模块中禁用与springdoc冲突的自动配置类。
• 测试需分模块执行，避免跨模块测试导致类加载污染。

内容的提问来源于stack exchange，提问作者aleksandr-chermashentsev