多模块Gradle项目中Spring dependency-management插件依赖管理失效

问题根源 #

你的子模块未应用Spring Dependency Management插件，导致根项目中dependencyManagement块定义的版本规则没有被子模块继承。子模块在声明依赖时只写了GAV的前两部分（无版本号），Gradle无法找到对应的依赖包，因此抛出“Could not find”错误。

修复步骤 #

1. 修改根项目build.gradle，让所有子模块继承依赖管理插件
   在allprojects块中添加应用io.spring.dependency-management插件的配置，确保所有子模块能读取根项目的依赖版本规则：

   plugins {
       id "io.spring.dependency-management" version "1.1.3" apply false
       id "org.springframework.boot" version "3.1.3" apply false
   }
   
   allprojects {
       apply plugin: 'java'
       // 新增：让所有子模块应用依赖管理插件
       apply plugin: 'io.spring.dependency-management'
       group 'com.epam.esm'
       sourceCompatibility = '17'
       targetCompatibility = '17'
       repositories {
           mavenCentral()
       }
   }
   
   dependencyManagement {
       dependencies {
           dependency 'org.projectlombok:lombok:1.18.26'
           dependency 'org.springframework.boot:spring-boot-starter-web:3.1.3'
           dependency 'org.springframework.boot:spring-boot-starter:3.1.3'
           dependency 'com.fasterxml.jackson.core:jackson-databind:2.14.2'
           dependency 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.14.2'
           dependency 'org.mapstruct:mapstruct-processor:1.5.3.Final'
           dependency 'org.mapstruct:mapstruct:1.5.3.Final'
           dependency 'org.zalando:problem-spring-web:0.27.0'
           dependency 'com.amazonaws:aws-java-sdk-s3:1.12.6'
       }
       imports {
           mavenBom 'org.springframework.cloud:spring-cloud-dependencies:2022.0.3'
       }
   }
   

2. 优化子模块依赖配置（可选但推荐）
   lombok和mapstruct-processor是编译期注解处理器，无需作为运行时依赖，建议调整为compileOnly和annotationProcessor配置，减少最终产物的依赖体积：

   dependencies {
       compileOnly 'org.projectlombok:lombok'
       annotationProcessor 'org.projectlombok:lombok'
       implementation 'org.springframework.boot:spring-boot-starter-web'
       implementation 'org.springframework.boot:spring-boot-starter'
       implementation 'com.fasterxml.jackson.core:jackson-databind'
       implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jsr310'
       annotationProcessor 'org.mapstruct:mapstruct-processor'
       implementation 'org.mapstruct:mapstruct'
       implementation 'org.zalando:problem-spring-web'
       implementation 'com.amazonaws:aws-java-sdk-s3'
   }
   

验证修复 #

执行以下命令重新构建项目：

./gradlew clean build --refresh-dependencies

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