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

分布式架构与微服务架构的区别：分布式架构侧重于压力的分散，强调的是服务的分散化；微服务架构侧重于能力的分散，更强调服务的专业化和精细分工。

2. Spring Cloud 概述

2.1 微服务、Spring Cloud 与 Spring Boot 的关系

• 微服务是架构思想：强调将单个应用拆分为一组小型的、独立部署的服务，每个服务围绕业务能力构建。但思想落地需要工具——服务发现、配置中心、负载均衡等这些分布式系统要解决的问题，微服务本身并不提供。
• Spring Cloud 是构建微服务架构的一套解决方案：规定了应用间协作的标准方式，涵盖以下核心组件：
  • 服务发现：互相知道在哪里。
  • 远程调用：支持服务间接口调用。
  • 负载均衡：将请求/流量按照规定的算法分配到处理同一业务的不同机器上。
  • 配置管理：外部化动态配置和集中化管理配置。
  • API 网关：请求的统一入口。
• Spring Boot 是构建单个微服务的基础框架：通过自动配置、起步依赖和嵌入式容器等特性，快速创建独立运行的 Spring 应用。

2.2 Spring Cloud 的实现方式

Spring Cloud 本身是一套标准/规范，具体实现方式主要分为以下几种技术选型方案。

站在 Java 的视角进行类比的话，Spring Cloud 相当于定义了一堆 interface，下述的 Spring Cloud Netflix/Spring Cloud Alibaba 相当于同一接口的不同实现类。

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 的全局变量定义区，用于集中管理项目中重复使用的配置值。

<!-- 语法 --><spring-boot.version>3.2.4</spring-boot.version><!-- 引用方式 --><version>${spring-boot.version}</version>

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

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

pom + import 表示将外部的一个 POM 文件导入当前项目。

<!-- 示例 --><dependencyManagement><dependencies><!-- SpringCloud 微服务 --><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><!-- 版本:2025.0.0 --><version>${spring-cloud.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>

Ctrl + 鼠标左键点击 groupId 或 artifactId 标签的内容，跳转到导入的 POM 文件查看源码。

总之，上述示例中的配置作用是：采用 Spring Cloud 官方 BOM 作为版本基准，将其内所有组件版本定义合并入当前项目的版本管理中心。此后引入具体 Spring Cloud 组件时无需再书写版本号，实现版本统一管控。

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

3.2.2 modules (子工程)

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