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

1.3 微服务架构

微服务是分布式架构的更精细实践，强调将应用拆分为一组微小、自治的服务。

注意区分：分布式侧重压力分散，微服务侧重能力分散与专业化分工。

2. Spring Cloud 概览

2.1 三者关系

• 微服务：是一种架构思想，强调拆分，但本身不提供工具落地。
• Spring Cloud：提供了一套构建微服务的标准解决方案，涵盖服务发现、远程调用、负载均衡、配置管理、API 网关等核心组件。
• Spring Boot：构建单个微服务的基础框架，通过自动配置、起步依赖快速创建独立运行的应用。

2.2 技术选型

Spring Cloud 是一套规范，具体实现主要有以下几种方案：

站在 Java 视角类比，Spring Cloud 像是一堆 Interface，而 Netflix 和 Alibaba 则是不同的实现类。

2.3 版本对应

建议参考官方文档获取最新稳定版信息：

• Spring Cloud
• Spring Cloud Alibaba

3. 父子工程搭建实战

3.1 项目结构

典型的 Maven 多模块结构如下：

3.2 依赖管理与 POM 解析

父工程 (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：全局变量定义区，集中管理重复配置值，方便后续引用 ${variable}。
• dependencyManagement：Maven 依赖版本管理中心。这里只管理版本号，不实际引入依赖。子模块继承后，引入相关组件时无需再写 <version>。
• BOM 导入：type=pom 且 scope=import 表示将外部 POM 文件中的依赖列表导入当前项目的版本管理。这样做的目的是采用 Spring Cloud 官方 BOM 作为版本基准，确保所有组件版本一致，避免冲突。

子模块 (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>
    
    <!-- 继承父 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 构建数据模型

在 core 模块下定义订单和商品的实体类，使用 Lombok 简化代码。

@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;
}

初始化数据库

我们需要准备两张表，分别对应订单服务和产品服务。

-- 订单服务数据库
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 配置文件编写

订单服务 (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 # 自动驼峰转换

商品服务 (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 启动项目

子服务会继承父工程的依赖。创建对应的启动类即可运行。

@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);
    }
}

至此，基础的微服务工程骨架已搭建完成，后续可以在此基础上接入注册中心、配置中心等组件。