Spring Cloud 微服务环境与工程搭建指南

三、工程搭建

3.1 构建父子工程

创建一个空的 Maven 项目作为父工程，只保留 pom.xml。父工程打包方式设为 pom，用于统一管理依赖版本。

父工程 pom.xml：

<?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>
        </dependencies>
    </dependencyManagement>
</project>

这里使用 dependencyManagement 声明依赖版本，子模块只需引入 artifactId 即可自动继承版本号，无需重复指定。

3.2 创建子模块

分别创建订单服务和商品服务两个子模块。子模块依赖 Web、MySQL 和 MyBatis。

子模块 pom.xml 片段：

<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>
    <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>

四、业务实现

4.1 订单服务代码

启动类需添加 @SpringBootApplication 注解。配置文件设置端口为 8080，并配置数据源和 MyBatis 日志输出。

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:
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
      map-underscore-to-camel-case: true

实体类使用 Lombok 简化代码，Controller 层接收请求，Service 层调用 Mapper，Mapper 层直接编写 SQL。

OrderInfo.java：

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

OrderController.java：

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

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

OrderService.java：

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

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

OrderMapper.java：

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

商品服务代码类似，此处省略。

4.2 远程调用实现

需求是在查询订单时，根据订单中的产品 ID 获取商品详细信息。最直接的方式是通过 HTTP 请求调用商品服务。

定义 RestTemplate：

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

修改 OrderService：

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

    public OrderInfo selectOrderById(Integer orderId) {
        OrderInfo orderInfo = orderMapper.selectOrderById(orderId);
        // 注意：实际生产中建议使用服务发现，而非硬编码 IP
        String url = "http://127.0.0.1:9090/product/" + orderInfo.getProductId();
        ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
        orderInfo.setProductInfo(productInfo);
        return orderInfo;
    }
}

五、RESTful 与问题探讨

RestTemplate 是 Spring 提供的同步 HTTP 客户端工具。REST 是一种架构风格，强调资源标识符（URI）、表现层格式（如 JSON）和状态转移（HTTP 方法）。

虽然 RESTful API 规范清晰，但在实际开发中，过于严格的 RESTful 设计可能会增加沟通成本或浏览器兼容性问题。例如，GET/POST 之外的方法在某些场景下不如 URL 路径直观。因此，API 设计应遵循'合适优于标准'，在团队内部达成共识即可。

当前方案存在明显不足：URL 中的 IP 和端口是硬编码的，更换部署环境需修改代码；缺乏负载均衡机制；远程调用复用性不高。这些问题将在后续 Spring Cloud 组件的学习中逐一解决。

六、总结

本文完成了 Spring Cloud 微服务的基础环境搭建，包括 JDK 17 配置、Maven 父子工程结构、数据库初始化以及基于 RestTemplate 的远程调用实现。通过订单与商品服务的拆分，展示了微服务的基本形态，同时也揭示了传统 HTTP 调用方式的局限性，为后续引入服务注册发现、负载均衡等组件做好了铺垫。