【Java】Gradle 多模块项目实战：Spring Boot 微服务搭建全流程

gradle-wrapper.properties

其中 gradle 组件使用了国内阿里云的镜像。

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/v9.3.1/gradle-9.3.1-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

settings.gradle

// 注册所有微服务子项目，名称与子项目目录名完全一致
include 'takeout-service', 'shop-service'

build.gradle

// 根项目 build.gradle（Groovy DSL）
// ########## 核心 1：buildscript 声明插件依赖（Gradle 构建自身的依赖）##########
buildscript {
    // 插件仓库（必须配置，拉取 Spring Boot 插件）
    repositories {
        mavenLocal()
        // 第一步：优先从阿里云镜像拉取（速度快）
        maven { url = 'https://maven.aliyun.com/repository/public/' }
        maven { url = 'https://maven.aliyun.com/repository/gradle-plugin' }
        // 第二步：镜像未找到时，官方仓库兜底（可选）
        gradlePluginPortal()
        mavenCentral()
    }
    // 声明插件的 Maven 坐标（group:name:version）
    dependencies {
        classpath "org.springframework.boot:spring-boot-gradle-plugin:4.0.2"
    }
}

// ########## 全局公共配置 ##########
allprojects {
    group = 'com.example'
    version = '0.1.0'
    repositories {
        maven { url = 'https://maven.aliyun.com/repository/public/' }
        mavenLocal()
        mavenCentral()
    }
}

// ########## 核心 2：subprojects 中统一应用插件（无 id() 方法，用 apply plugin）##########
subprojects {
    // 应用核心插件+Spring Boot 插件（无语法冲突）
    apply plugin: 'java'
    apply plugin: 'maven-publish'
    apply plugin: 'org.springframework.boot'
    apply plugin: 'io.spring.dependency-management'

    java {
        toolchain {
            languageVersion = JavaLanguageVersion.of(25)
            // 所有子模块统一使用 Java 25
        }
    }

    // 全局版本常量 + 公共依赖（与之前一致）
    dependencies {
        testImplementation 'org.springframework.boot:spring-boot-starter-test'
        // Gradle 9.x 需显式声明 JUnit 5 平台启动器
        // testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
    }

    // Spring Cloud 版本统一（可选）
    dependencyManagement {
        imports {
            mavenBom "org.springframework.cloud:spring-cloud-dependencies:2025.1.0"
        }
    }

    // 核心配置：启用 JUnit 5 平台，让 Gradle 识别 JUnit 5 的@Test 注解
    tasks.test {
        useJUnitPlatform()
        // 必须添加，否则 Gradle 无法扫描 JUnit 5 测试用例
    }
}

shop-service/build.gradle

// 子项目 shop-service/build.gradle（Groovy DSL）
// 无需重复写 repositories、group、version、公共依赖！
// 仅写当前微服务特有的依赖/配置
dependencies {
    // 自身业务特有依赖（如用户模块的持久层、服务层依赖）
    implementation 'org.springframework.boot:spring-boot-starter-webmvc'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
    runtimeOnly("com.h2database:h2")
}

// 可选：覆盖全局配置（如需单独指定版本/插件）
// version = '1.0.1' // 覆盖根项目的 version

ShopServiceApplication.java

package com.example;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/// 购物服务
@RestController
@SpringBootApplication
public class ShopServiceApplication {
    /// 构造方法
    public ShopServiceApplication() {}

    private static final Logger log = LoggerFactory.getLogger(ShopServiceApplication.class);

    /**
     * 主方法
     * @param args 命令行参数
     */
    public static void main(String[] args) {
        SpringApplication.run(ShopServiceApplication.class, args);
    }

    /**
     * hello
     *
     * @return hello
     */
    @GetMapping("hello")
    public String hello() {
        log.info("hello");
        return "hello";
    }
}

shop-service/src/main/resources/application.yml

spring:
  application:
    name: shop-service
  datasource:
    url: jdbc:h2:mem:${spring.application.name}
server:
  port: 8081

takeout-service/build.gradle

// 子项目 takeout-service/build.gradle（Groovy DSL）
// 无需重复写 repositories、group、version、公共依赖！
// 仅写当前微服务特有的依赖/配置
dependencies {
    // 自身业务特有依赖（如用户模块的持久层、服务层依赖）
    implementation 'org.springframework.boot:spring-boot-starter-webmvc'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-actuator'
    runtimeOnly("com.h2database:h2")
}

// 可选：覆盖全局配置（如需单独指定版本/插件）
// version = '1.0.1' // 覆盖根项目的 version

TakeoutServiceApplication.java

package com.example;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/// 外卖服务
@RestController
@SpringBootApplication
public class TakeoutServiceApplication {
    /// 构造方法
    public TakeoutServiceApplication() {}

    private static final Logger log = LoggerFactory.getLogger(TakeoutServiceApplication.class);

    /**
     * 主方法
     * @param args 命令行参数
     */
    public static void main(String[] args) {
        SpringApplication.run(TakeoutServiceApplication.class, args);
    }

    /**
     * hello
     *
     * @return hello
     */
    @GetMapping("hello")
    public String hello() {
        log.info("hello");
        return "hello";
    }
}

takeout-service/src/main/resources/application.yml

spring:
  application:
    name: takeout-service
  datasource:
    url: jdbc:h2:mem:${spring.application.name}

引用

[1] 崔娟，张生月，章恒.Maven 与 Gradle 构建工具对比分析 [J].科技创新与应用，2025,15(21):93-96.DOI:10.19981/j.CN23-1581/G3.2025.21.021.