Gradle 8 架构下共享依赖定义与Spring Boot插件共享配置问题求助

嗨，我来帮你梳理下这个问题的解决思路，Gradle的预编译约定脚本（也就是你用的java-common-conventions.gradle）确实有和普通build脚本不一样的规则，咱们一步步来解决：

一、解决Spring Boot插件版本报错问题 #

你遇到的这个错误，核心原因是预编译脚本（约定插件）里不能直接指定插件版本——因为这类脚本本身属于Gradle插件的范畴，插件版本需要统一在项目根目录的settings.gradle中做全局管理，具体操作如下：

1. 在根项目的settings.gradle中添加pluginManagement块，统一声明插件版本：

pluginManagement {
    repositories {
        gradlePluginPortal() // Gradle插件仓库
        mavenCentral()       // 必要的话添加Maven中央仓库
    }
    plugins {
        // 在这里统一管理所有插件的版本
        id 'org.springframework.boot' version '2.7.10'
        // 如果用到Spring的依赖管理插件，也可以一起声明版本
        id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    }
}

2. 回到你的java-common-conventions.gradle中，直接引用插件ID即可，不需要带版本：

plugins {
    id 'java'
    id 'org.springframework.boot'
    id 'io.spring.dependency-management' // 若需要依赖管理插件则添加
}

这样配置后，所有子项目只要应用这个约定插件，就能自动继承Spring Boot插件的配置，不用每个子项目重复写了。

二、共享依赖的配置方式 #

共享依赖的最佳实践是直接在约定插件中定义，这样所有应用该插件的子项目都会自动继承这些依赖，避免重复配置：

在java-common-conventions.gradle中添加共享依赖的dependencies块：

dependencies {
    // 示例：共享的测试依赖
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.2'
    
    // 示例：共享的Spring Boot Starter依赖
    implementation 'org.springframework.boot:spring-boot-starter-web'
}

之后子项目只需要在自己的build.gradle中应用约定插件即可，不用重复写共享依赖：

plugins {
    id 'java-common-conventions'
}

// 这里可以添加子项目专属的依赖，比如业务相关的包

三、关于allprojects和subprojects的位置 #

如果还是习惯用传统的全局配置方式，这两个闭包应该放在**根项目的build.gradle**中，比如：

// 对所有项目（包括根项目）生效的配置，比如仓库设置
allprojects {
    repositories {
        mavenCentral()
        gradlePluginPortal()
    }
}

// 只对子项目生效的配置，比如插件、通用依赖
subprojects {
    plugins {
        id 'java'
    }
    dependencies {
        testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.2'
    }
}

不过要注意，Gradle官方现在更推荐用预编译约定插件来替代allprojects/subprojects，因为约定插件更模块化、更容易维护，也更贴合Gradle现代架构的设计理念。

备注：内容来源于stack exchange，提问作者Kush Singh