Gradle多模块项目如何配置依赖与插件继承？

云原生阿岚

2026-7-6

问题解答

1. domain子模块是否应该继承父模块的依赖与插件？

必须继承。多模块项目的核心价值就是复用配置、统一版本管控、减少重复代码。父模块负责定义全局通用的插件、依赖版本、编译环境等配置，子模块只需要补充自身业务专属的依赖和配置即可，能有效避免版本不一致、配置冗余的问题。

2. 移除子模块插件后无法工作的原因

你当前的问题主要出在这几个点：

若移除java插件：Gradle会丢失编译、测试、打包等核心任务，子模块连基础的代码编译都无法完成，自然无法正常工作。
若移除io.spring.dependency-management插件：子模块无法继承父模块的依赖版本管理，比如父模块里lombok没指定版本，子模块也没写版本号的话，Gradle会找不到对应依赖；同时Spring Boot starter依赖的版本也会失去管控，容易引发依赖冲突或缺失。
额外提醒：你的domain模块其实不需要加org.springframework.boot插件——这个插件是用来将模块打包成可执行Spring Boot应用的，domain作为业务实体库模块，完全不需要这个插件，当前子模块加了它反而会引入不必要的打包配置。

3. 正确的继承配置方式

父模块（根模块）build.gradle调整

根模块应该作为纯配置管理模块，不要把它当成Spring Boot应用模块（单独的启动模块比如app/web模块才需要Spring Boot插件），配置如下：

plugins {
    id 'java'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    // Spring Boot插件放到启动子模块中，根模块无需添加
}

group = 'ez.ndvz'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17'
}

repositories {
    mavenCentral()
}

// 统一管理所有依赖版本，包括Spring Boot、Lombok等
dependencyManagement {
    imports {
        mavenBom org.springframework.boot.gradle.plugin.SpringBootPlugin.BOM_COORDINATES
    }
    dependencies {
        dependency 'org.projectlombok:lombok:1.18.26'
    }
}

// 全局测试任务配置
tasks.named('test') {
    useJUnitPlatform()
}

domain子模块build.gradle配置

子模块只需要继承父模块配置，补充自身专属依赖即可：

plugins {
    id 'java'
    id 'io.spring.dependency-management'
    // 移除org.springframework.boot插件，domain是库模块不需要
}

// 继承父模块的sourceCompatibility，无需重复定义

repositories {
    mavenCentral()
}

dependencies {
    // 若domain不需要Spring基础上下文，可去掉spring-boot-starter
    implementation 'jakarta.validation:jakarta.validation-api'
    implementation 'org.projectlombok:lombok'
    // 测试依赖可继承父模块，无需重复声明，有特殊需求再单独配置
}

// 测试任务继承父模块配置，无需重复写

启动模块（如app模块）build.gradle配置

只有负责启动Spring Boot应用的模块才需要添加Spring Boot插件：

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

dependencies {
    implementation project(':domain')
    implementation 'org.springframework.boot:spring-boot-starter-web' // 示例：web场景依赖
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

这样配置后，所有子模块都会继承父模块的依赖版本、编译环境和插件配置，既减少了重复代码，又保证了版本一致性，同时每个模块各司其职。

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