Spring Cloud 微服务架构概述与工程搭建实战

2.3 版本对应关系

参考 Spring Cloud 官方文档及 Spring Cloud Alibaba 文档获取最新信息。

3. 父子工程搭建

3.1 项目结构

典型的 Maven 多模块项目结构如下所示。

3.2 依赖导入和 pom 文件解析

3.2.1 spring-cloud-blog

这是父工程，负责统一管理依赖版本。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.example</groupId>
    <artifactId>spring-cloud-blog</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>modules</module>
    </modules>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <java.version>17</java.version>
        <mybatis.version>3.0.3</mybatis.version>
        <mysql.version>8.0.33</mysql.version>
        <spring-cloud.version>2025.0.0</spring-cloud.version>
        <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>
        <spring-boot.version>3.5.0</spring-boot.version>
        <common-core.version>1.0-SNAPSHOT</common-core.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <!-- SpringCloud 微服务 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- SpringCloud Alibaba 微服务 -->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud-alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- SpringBoot -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- mybatis -->
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            <!-- MySQL 驱动 -->
            <dependency>
                <groupId>com.mysql</groupId>
                <artifactId>mysql-connector-j</artifactId>
                <version>${mysql.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

properties：Maven 的全局变量定义区，用于集中管理项目中重复使用的配置值。

dependencyManagement：Maven 依赖版本管理中心，只管理版本，不引入依赖。

BOM 导入 (当前配置)：BOM 是一个特殊的 POM 文件，里面只干一件事——定义一堆依赖的版本号。

pom + import 表示将外部的一个 POM 文件导入当前项目。采用 Spring Cloud 官方 BOM 作为版本基准，将其内所有组件版本定义合并入当前项目的版本管理中心。此后引入具体 Spring Cloud 组件时无需再书写版本号，实现版本统一管控。

dependencies：依赖引入区，这里写的每个依赖都会被下载、被 classpath 加载、被项目使用。

3.2.2 modules

子模块继承父 POM 的所有配置。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <!-- Maven 的继承声明，让子模块继承父 POM 的所有配置 -->
    <parent>
        <groupId>org.example</groupId>
        <artifactId>spring-cloud-blog</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <artifactId>modules</artifactId>
    <packaging>pom</packaging>
    <modules>
        <module>order-service</module>
        <module>product-service</module>
    </modules>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>core</artifactId>
            <version>${common-core.version}</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>
</project>

3.3 构建数据

3.3.1 创建实体类

在 core 模块下创建订单和商品的实体类。

@Data
public class OrderInfo {
    private Integer id;
    private Integer userId;
    private Integer productId;
    private Integer num;
    private Integer price;
    private Integer deleteFlag;
    private Date createTime;
    private Date updateTime;
    private ProductInfo productInfo;
}

@Data
public class ProductInfo {
    private Integer id;
    private String productName;
    private Integer productPrice;
    private Integer status;
    private Date createTime;
    private Date updateTime;
}

3.3.2 初始化数据库

-- 订单服务
create database if not exists cloud_order charset utf8mb4;
use cloud_order;
drop table if exists order_detail;
create table order_detail (
  `id` int primary key auto_increment comment '订单 id',
  `user_id` bigint(20) not null comment '用户 ID',
  `product_id` bigint(20) null comment '产品 id',
  `num` INT(10) null default 0 comment '下单数量',
  `price` bigint(20) not null comment '实付款',
  `delete_flag` tinyint(4) null default 0,
  `create_time` datetime default now(),
  `update_time` datetime default now()
);
insert into order_detail (user_id, product_id, num, price)
values (2001, 1001, 1, 99), (2002, 1002, 1, 30), (2001, 1003, 1, 40),
       (2003, 1004, 3, 58), (2004, 1005, 7, 85), (2005, 1006, 7, 94);

-- 产品服务
create database if not exists cloud_product charset utf8mb4;
use cloud_product;
drop table if exists product_detail;
create table product_detail (
  `id` int primary key auto_increment comment '产品 id',
  `product_name` varchar(128) null comment '产品名称',
  `product_price` bigint(20) not null comment '产品价格',
  `state` tinyint(4) null default 0 comment '产品状态 0-有效 1-下架',
  `create_time` datetime default now(),
  `update_time` datetime default now()
);
insert into product_detail (id, product_name, product_price, state)
values (1001, "T 恤", 101, 0), (1002, "短袖", 30, 0), (1003, "短裤", 44, 0),
       (1004, "卫衣", 58, 0), (1005, "马甲", 98, 0), (1006, "羽绒服", 101, 0),
       (1007, "冲锋衣", 30, 0), (1008, "袜子", 44, 0), (1009, "鞋子", 58, 0),
       (10010, "毛衣", 98, 0);

3.4 初始化配置文件

3.4.1 订单服务

application.yml

server:
  port: 8000
spring:
  application:
    name: order-service
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/cloud_order?characterEncoding=utf8&useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  mybatis:
    configuration:
      map-underscore-to-camel-case: true # 自动驼峰转换

3.4.2 商品服务

application.yml

server:
  port: 9000
spring:
  application:
    name: product-service
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/cloud_product?characterEncoding=utf8&useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  mybatis:
    configuration:
      map-underscore-to-camel-case: true # 自动驼峰转换

3.5 启动项目

order-service 和 product-service 服务会继承父工程的所有依赖，创建启动类然后启动即可。

@SpringBootApplication
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

@SpringBootApplication
public class ProductServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProductServiceApplication.class, args);
    }
}