Spring Cloud 微服务环境搭建与工程初始化

商品服务数据库

create database if not exists cloud_product charset utf8mb4;

-- 产品表
DROP TABLE IF EXISTS product_detail;
CREATE TABLE product_detail (
  `id` INT NOT NULL 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(),
  PRIMARY KEY (`id`)
) ENGINE = INNODB DEFAULT CHARACTER SET = utf8mb4 COMMENT ='产品表';

-- 数据初始化
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);

工程搭建

构建父子工程

创建父工程

创建一个空的 Maven 项目，删除所有代码，只保留 pom.xml。目录结构应保持简洁。

完善 pom.xml，主要包含三部分：

1. 声明父级 spring-boot-starter-parent。
2. 使用 <properties> 统一管理版本号。
3. 使用 <dependencyManagement> 管理依赖版本，子项目引入时只需指定 groupId 和 artifactId。

<?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-demo</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.6</version>
        <relativePath/>
    </parent>
    <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>2022.0.3</spring-cloud.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
            <dependency>
                <groupId>com.mysql</groupId>
                <artifactId>mysql-connector-j</artifactId>
                <version>${mysql.version}</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter-test</artifactId>
                <version>${mybatis.version}</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

注意：dependencyManagement 仅声明依赖版本，不会自动引入 jar 包。子项目若需使用相关依赖，必须在自身的 dependencies 中显式声明。

创建子项目 - 订单服务

在父工程下新建 Module，命名为 order-service。添加基础依赖和构建插件：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
    </dependency>
    <!-- mybatis -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

创建子项目 - 商品服务

操作同上，创建 product-service 模块并配置相同的依赖。

完善业务代码

订单服务实现

启动类与配置

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

application.yml 配置示例：

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/cloud_order?characterEncoding=utf8&useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.cj.jdbc.Driver
  mybatis:
    configuration:
      # 配置打印 MyBatis 日志
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
      map-underscore-to-camel-case: true

实体类与 Controller

使用 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;
}

Controller 层暴露接口：

@RequestMapping("/order")
@RestController
public class OrderController {
    @Autowired
    private OrderService orderService;

    @RequestMapping("/{orderId}")
    public OrderInfo getOrderById(@PathVariable("orderId") Integer orderId) {
        return orderService.selectOrderById(orderId);
    }
}

Service 与 Mapper

@Service
public class OrderService {
    @Autowired
    private OrderMapper orderMapper;

    public OrderInfo selectOrderById(Integer orderId) {
        OrderInfo orderInfo = orderMapper.selectOrderById(orderId);
        return orderInfo;
    }
}

@Mapper
public interface OrderMapper {
    @Select("select * from order_detail where id=#{orderId}")
    OrderInfo selectOrderById(Integer orderId);
}

商品服务的代码结构与订单服务类似，此处不再赘述。

远程调用实战

需求分析

在查询订单详情时，需要根据订单中的 product_id 获取商品的详细信息。此时，订单服务需要调用商品服务。

实现方式

采用 Spring 提供的 RestTemplate 进行 HTTP 请求。思路是：订单服务向商品服务发送请求，获取结果后融合到订单信息中返回。

1. 定义 RestTemplate Bean

@Configuration
public class BeanConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}

2. 修改 OrderService

注入 RestTemplate 并发起调用：

@Service
public class OrderService {
    @Autowired
    private OrderMapper orderMapper;
    @Autowired
    private RestTemplate restTemplate;

    public OrderInfo selectOrderById(Integer orderId) {
        OrderInfo orderInfo = orderMapper.selectOrderById(orderId);
        // 构造商品服务 URL
        String url = "http://127.0.0.1:9090/product/" + orderInfo.getProductId();
        ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
        orderInfo.setProductInfo(productInfo);
        return orderInfo;
    }
}

RestTemplate 与 RESTful 风格

RestTemplate 是 Spring 3.0 引入的 HTTP 客户端工具，封装了常见的 REST 请求方案。

什么是 REST？

REST（Representational State Transfer）是一种软件架构风格，核心概念包括：

1. 资源：网络上的事物抽象为资源，有唯一标识符（URI）。
2. 表现层：资源的表现形式，如 JSON、XML 等。
3. 状态转移：通过 HTTP 协议（GET、POST、PUT、DELETE）对资源进行操作。

RESTful API 的实践

RESTful 强调统一接口和资源导向。例如：

• GET /blog/{blogId}：查询博客
• DELETE /blog/{blogId}：删除博客

但在实际开发中，完全遵循 RESTful 标准有时会增加成本。例如，HTTP Method 不如 URL 直观，部分浏览器对非 GET/POST 方法支持不佳。因此，设计接口时应遵循'合适优于规范'的原则，在保证团队沟通效率的前提下灵活调整。

当前方案的局限性

虽然上述方案实现了基本功能，但在生产环境中还存在明显问题：

1. 硬编码 IP：URL 写死了 127.0.0.1:9090，更换服务器地址需修改代码。
2. 缺乏负载均衡：多机部署时无法分摊压力。
3. 调用不优雅：URL 容易拼错，复用性差。
4. 权限风险：所有服务理论上都能直接调用该接口。

这些问题将在后续 Spring Cloud 组件的学习中逐一解决，例如通过服务注册发现、负载均衡器等机制优化远程调用体验。

总结

本文完成了 Spring Cloud 微服务的基础环境搭建，包括 JDK 选型、Maven 父子工程结构、数据库初始化以及基于 RestTemplate 的服务间调用。同时梳理了微服务拆分原则及 RESTful 设计的权衡策略，为后续深入学习 Spring Cloud 生态打下了基础。