独立Java微服务的Gradle公共依赖版本统一方案咨询

针对多个独立Java微服务的Gradle依赖版本集中管控需求（无法使用多模块），以下是三种可行方案：

方案一：创建独立的Gradle BOM（平台项目） #

这是Gradle官方推荐的标准化方案，通过创建独立的依赖平台项目（类似Maven BOM）来集中管理所有公共依赖的版本，同时支持依赖冲突自动解决。

步骤1：创建独立的依赖平台项目 #

新建一个单独的Gradle项目，核心配置如下：

build.gradle：

plugins {
    id 'java-platform'
    id 'maven-publish' // 用于发布到本地/私有仓库
}

javaPlatform {
    allowDependencies() // 允许声明依赖约束或直接依赖
}

dependencies {
    // 导入Spring Boot官方BOM，继承其内置依赖版本
    api platform('org.springframework.boot:spring-boot-dependencies:3.2.0')
    
    // 声明自定义公共依赖的版本约束（可覆盖Spring Boot BOM的版本）
    constraints {
        api 'org.junit.jupiter:junit-jupiter-api:5.10.1'
        api 'org.junit.jupiter:junit-jupiter-engine:5.10.1'
        api 'org.projectlombok:lombok:1.18.30'
        // 添加其他公共依赖版本
    }
}

// 发布到本地Maven仓库（方便本地测试）
publishing {
    publications {
        maven(MavenPublication) {
            from components.javaPlatform
        }
    }
}

settings.gradle：

rootProject.name = 'gradle-dependency-platform'

步骤2：发布平台项目 #

执行命令将项目发布到本地仓库：

./gradlew publishToMavenLocal

生产环境可配置发布到私有仓库（如Nexus、Artifactory）。

步骤3：在微服务中引用BOM #

在每个微服务的build.gradle中导入该BOM，无需再写依赖版本：

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.2.0'
    id 'io.spring.dependency-management' version '1.1.4'
}

// 导入自定义依赖平台
dependencyManagement {
    imports {
        mavenBom 'com.yourcompany:gradle-dependency-platform:1.0.0'
    }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.junit.jupiter:junit-jupiter-api'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
}

方案二：共享版本属性文件 #

如果不需要依赖冲突处理，可通过共享属性文件快速实现版本集中管理。

步骤1：创建共享属性文件 #

新建shared-deps.properties文件，定义所有公共依赖版本：

springBootVersion=3.2.0
junitJupiterVersion=5.10.1
lombokVersion=1.18.30

步骤2：在微服务中引入属性文件 #

在每个微服务的build.gradle中引入该文件，并使用变量引用版本：

// 引入共享属性文件（可通过版本控制同步到各项目，或放在本地共享目录）
apply from: file('../shared-deps.properties')

plugins {
    id 'java'
    id 'org.springframework.boot' version springBootVersion
    id 'io.spring.dependency-management' version '1.1.4'
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation "org.junit.jupiter:junit-jupiter-api:${junitJupiterVersion}"
    testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:${junitJupiterVersion}"
    compileOnly "org.projectlombok:lombok:${lombokVersion}"
    annotationProcessor "org.projectlombok:lombok:${lombokVersion}"
}

方案三：本地开发用includeBuild #

如果是本地开发场景，多个微服务项目在同一目录下，可通过includeBuild直接引用本地的依赖平台项目，无需发布到仓库：

在每个微服务的settings.gradle中添加：

includeBuild '../gradle-dependency-platform'

之后在build.gradle中按方案一的方式导入BOM即可，修改平台项目的版本后，微服务会自动同步。

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