服务注册与分布式协调 / 系统课时

搭建订单与库存微服务演练

搭建订单与库存微服务演练

本节把注册发现、Feign 调用、动态配置、环境隔离和鉴权串成一条可验证链路:订单服务通过 Nacos 找到库存服务,库存阈值由 Nacos 动态下发,最后用故障注入确认命名空间、分组和凭据确实参与了治理。

学习目标

  • 搭建 order-service 调用 inventory-service 的最小可运行链路。
  • 用 Nacos Namespace、Group 和账号凭据同时约束服务发现与配置读取。
  • 修改库存阈值后不重启服务完成验证,并能定位常见隔离与鉴权错误。

明确演练链路

验收时只观察一条业务请求:客户端请求订单服务,订单服务通过 OpenFeign 按服务名 inventory-service 发起调用;服务实例来自 Nacos Discovery,库存阈值来自 Nacos Config。两个服务必须位于同一个 Namespace 和 SHOP_GROUP,并使用有效账号访问 Nacos。

订单调用库存的 Nacos 治理链路

本演练使用 spring.config.import 导入动态配置。两个 Maven 工程使用同一套 Spring Boot、Spring Cloud 与 Spring Cloud Alibaba BOM;订单服务需要 Web、Nacos Discovery、OpenFeign、LoadBalancer,库存服务需要 Web、Nacos Discovery、Nacos Config。

下面是两个 pom.xml 都要使用的版本管理片段;这是片段示例,需要放入完整 Maven 工程的 <project> 中。

xml
<properties>
    <java.version>17</java.version>
    <spring-cloud.version>2025.0.0</spring-cloud.version>
    <spring-cloud-alibaba.version>2025.0.0.0</spring-cloud-alibaba.version>
</properties>

<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>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>${spring-cloud-alibaba.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

订单服务的依赖片段如下。

xml
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-loadbalancer</artifactId>
    </dependency>
</dependencies>

库存服务的依赖片段如下。

xml
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>
</dependencies>

配置环境隔离与鉴权

先准备一个可访问的 Nacos 实例,并创建实验账号 demo-client。再创建开发环境 Namespace,记下它的真实 ID,运行应用时通过 NACOS_NAMESPACE 传入;不要把 Namespace 显示名称当成 ID。两个服务都使用 SHOP_GROUP,这样服务实例和动态配置处于同一环境边界。

order-service/src/main/resources/application.yml:

yaml
server:
  port: 8080

spring:
  application:
    name: order-service
  cloud:
    nacos:
      server-addr: ${NACOS_ADDR:127.0.0.1:8848}
      username: ${NACOS_USERNAME}
      password: ${NACOS_PASSWORD}
      discovery:
        namespace: ${NACOS_NAMESPACE}
        group: SHOP_GROUP
    loadbalancer:
      nacos:
        enabled: true

inventory-service/src/main/resources/application.yml:

yaml
server:
  port: 8081

spring:
  application:
    name: inventory-service
  cloud:
    nacos:
      server-addr: ${NACOS_ADDR:127.0.0.1:8848}
      username: ${NACOS_USERNAME}
      password: ${NACOS_PASSWORD}
      discovery:
        namespace: ${NACOS_NAMESPACE}
        group: SHOP_GROUP
      config:
        namespace: ${NACOS_NAMESPACE}
        group: SHOP_GROUP
  config:
    import:
      - nacos:inventory-service.yaml?group=SHOP_GROUP&refreshEnabled=true

在同一个 Namespace 下发布 Data ID 为 inventory-service.yaml、Group 为 SHOP_GROUP 的配置:

yaml
inventory:
  limit: 5

这份配置不要求控制台输出。验证标准是库存服务能启动,并且后续接口返回的 limit 为 5;如果配置读取失败,应先检查 Namespace ID、Group、账号权限和 Nacos 地址,而不是先改业务代码。

实现库存与订单服务

库存服务读取动态阈值,并用 @RefreshScope 让配置变更进入当前 Bean。以下两个 Java 文件依赖本节的 Maven 与 YAML 配置,不单独运行。

java
package com.example.inventory;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class InventoryApplication {
    public static void main(String[] args) {
        SpringApplication.run(InventoryApplication.class, args);
    }
}
java
package com.example.inventory;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RefreshScope
@RestController
@RequestMapping("/inventory")
public class InventoryController {

    @Value("${inventory.limit:5}")
    private int limit;

    @GetMapping("/check")
    public InventoryResult check(@RequestParam String sku, @RequestParam int count) {
        // 用动态阈值决定当前请求是否可分配库存。
        return new InventoryResult(sku, count, count <= limit, limit);
    }

    public record InventoryResult(String sku, int requested, boolean available, int limit) {
    }
}

订单服务不写库存地址,而是让 Feign 使用服务名查找实例。

java
package com.example.order;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}
java
package com.example.order;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

@FeignClient(name = "inventory-service")
public interface InventoryClient {

    @GetMapping("/inventory/check")
    InventoryResult check(@RequestParam("sku") String sku, @RequestParam("count") int count);

    record InventoryResult(String sku, int requested, boolean available, int limit) {
    }
}
java
package com.example.order;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/orders")
public class OrderController {

    private final InventoryClient inventoryClient;

    public OrderController(InventoryClient inventoryClient) {
        this.inventoryClient = inventoryClient;
    }

    @GetMapping("/check")
    public InventoryClient.InventoryResult check(
            @RequestParam String sku,
            @RequestParam int count) {
        // 这里没有主机与端口,实例选择交给服务发现与负载均衡。
        return inventoryClient.check(sku, count);
    }
}

运行并验证动态链路

分别在两个终端设置相同环境变量。<PASSWORD> 和 <NAMESPACE_ID> 替换为实际值;密码不要写进仓库。

bash
export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=demo-client
export NACOS_PASSWORD=<PASSWORD>
export NACOS_NAMESPACE=<NAMESPACE_ID>
mvn -f inventory-service/pom.xml spring-boot:run

预期输出:

text
<TIME> ... Started InventoryApplication ...

另一个终端设置同样变量后启动订单服务:

bash
export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=demo-client
export NACOS_PASSWORD=<PASSWORD>
export NACOS_NAMESPACE=<NAMESPACE_ID>
mvn -f order-service/pom.xml spring-boot:run

预期输出:

text
<TIME> ... Started OrderApplication ...

请求订单服务,确认 Feign 已通过注册中心找到库存服务:

bash
curl -s "http://127.0.0.1:8080/orders/check?sku=sku-1&count=2"

预期输出:

json
{"sku":"sku-1","requested":2,"available":true,"limit":5}

随后把 Nacos 中 inventory-service.yaml 的 inventory.limit 改为 1 并发布,不重启任何服务,再执行同一请求:

bash
curl -s "http://127.0.0.1:8080/orders/check?sku=sku-1&count=2"

预期输出:

json
{"sku":"sku-1","requested":2,"available":false,"limit":1}

如果第二次结果中的 limit 仍是 5,先确认 Data ID、Group、Namespace 与 refreshEnabled=true 是否一致,再检查库存 Bean 是否带有 @RefreshScope。

用故障注入完成验收

最后不要只验证“能通”,还要故意破坏治理条件。把订单服务的 NACOS_NAMESPACE 改成另一个环境后重启,订单服务应找不到开发环境中的 inventory-service;把 NACOS_PASSWORD 改错后重启,服务注册或配置读取应失败。恢复正确 Namespace 与凭据后,请求再次返回正常 JSON,说明业务调用、服务发现、动态配置、环境隔离和鉴权已经形成一条可重复验证的闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建订单与库存微服务演练

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通