SpringCloud-多模块项目实战：从零搭建微服务父子工程

1. 为什么需要多模块工程？

第一次接触微服务开发时，我习惯把所有代码都堆在一个工程里。结果随着功能增加，项目很快变成了"一锅粥"：配置文件互相覆盖、依赖版本冲突、构建时间越来越长。直到有次需要单独升级某个功能模块，才发现牵一发而动全身——这就是典型的单体应用痛点。

多模块工程就像乐高积木，把大系统拆分成多个独立又关联的小模块。以电商系统为例：

• 用户服务（user-service）
• 订单服务（order-service）
• 支付服务（payment-service）
  每个服务可以独立开发、测试、部署，又能通过父工程统一管理公共依赖。实测下来，这种结构让我们的团队协作效率提升了至少40%。

2. 环境准备与工具选择

2.1 基础环境配置

我推荐使用这套黄金组合：

• JDK 17（LTS版本稳定性最佳）
• Maven 3.8+（注意配置阿里云镜像加速）
• IntelliJ IDEA（社区版就够用）

验证环境是否就绪：

bash复制java -version
# 应输出类似：openjdk version "17.0.8" 2023-07-18

mvn -v
# 应显示Apache Maven 3.8.6及更高版本

2.2 Spring Initializr的隐藏技巧

访问start.spring.io时，新手常忽略这三个关键点：

1. 打包方式：父工程必须选pom类型
2. 元数据：GroupId建议用反向域名（如com.yourcompany）
3. 依赖选择：父工程只需勾选Spring Web，子模块再按需添加

3. 创建父工程的实战细节

3.1 初始化父项目

通过IDEA创建新项目时：

1. 选择Spring Initializr
2. 在Artifact输入springcloud-parent
3. 关键步骤：将Packaging从默认的jar改为pom

生成后的pom.xml需要手动添加：

xml复制<!-- 必须的父工程标识 -->
<packaging>pom</packaging>

<!-- 统一依赖管理 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 版本锁定的正确姿势

在父工程中定义属性块，这是我多年实践总结的最佳方案：

xml复制<properties>
    <java.version>17</java.version>
    <spring-boot.version>3.1.2</spring-boot.version>
    <spring-cloud.version>2022.0.3</spring-cloud.version>
    <!-- 统一日志版本 -->
    <logback.version>1.4.7</logback.version>
</properties>

4. 子模块开发全流程

4.1 创建提供者模块

右键父工程 → New → Module：

1. 命名user-service
2. 勾选Spring Web、Lombok
3. 关键配置：在子模块pom中必须声明父工程

xml复制<parent>
    <groupId>com.example</groupId>
    <artifactId>springcloud-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</parent>

配置文件技巧：

yaml复制# application.yml
server:
  port: 8081
spring:
  application:
    name: user-service
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa

4.2 消费者模块的特别处理

创建order-service时要注意：

1. 需要额外勾选OpenFeign（服务调用）
2. 配置中要声明服务注册中心（以Nacos为例）：

yaml复制spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

FeignClient示例：

java复制@FeignClient(name = "user-service")
public interface UserClient {
    @GetMapping("/users/{id}")
    User getUser(@PathVariable Long id);
}

5. 联调测试的避坑指南

5.1 模块间依赖管理

在父工程中定义公共依赖：

xml复制<!-- 公共依赖示例 -->
<dependencies>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

子模块引用其他模块时：

xml复制<dependency>
    <groupId>com.example</groupId>
    <artifactId>common-utils</artifactId>
    <version>${project.version}</version>
</dependency>

5.2 启动顺序控制

使用IDEA的Run Dashboard功能：

1. 确保所有模块的Application类被识别
2. 配置Nacos（如果有）最先启动
3. 接着启动提供者（user-service）
4. 最后启动消费者（order-service）

测试技巧：

bash复制# 同时检查所有服务健康状态
curl -X GET "http://localhost:8080/actuator/health"

6. 高级配置与优化建议

6.1 多环境配置方案

在父工程建立config目录：

code复制resources/
├── application-dev.yml
├── application-prod.yml
└── bootstrap.yml

通过VM参数切换环境：

code复制-Dspring.profiles.active=prod

6.2 构建效率优化

在父pom中添加并行构建配置：

xml复制<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <parallel>true</parallel>
                <threadCount>4</threadCount>
            </configuration>
        </plugin>
    </plugins>
</build>

7. 常见问题解决方案

依赖冲突排查：

bash复制mvn dependency:tree -Dverbose -Dincludes=:spring-core

端口占用处理：

java复制// 在测试类中添加
@SpringBootTest(webEnvironment = 
    SpringBootTest.WebEnvironment.RANDOM_PORT)

循环依赖预防：

1. 使用@Lazy注解
2. 重构代码为单向依赖
3. 引入事件驱动机制