服务注册与分布式协调 / 系统课时
搭建订单与库存微服务演练
搭建订单与库存微服务演练
本节把注册发现、Feign 调用、动态配置、环境隔离和鉴权串成一条可验证链路:订单服务通过 Nacos 找到库存服务,库存阈值由 Nacos 动态下发,最后用故障注入确认命名空间、分组和凭据确实参与了治理。
学习目标
- 搭建
order-service调用inventory-service的最小可运行链路。 - 用 Nacos Namespace、Group 和账号凭据同时约束服务发现与配置读取。
- 修改库存阈值后不重启服务完成验证,并能定位常见隔离与鉴权错误。
明确演练链路
验收时只观察一条业务请求:客户端请求订单服务,订单服务通过 OpenFeign 按服务名 inventory-service 发起调用;服务实例来自 Nacos Discovery,库存阈值来自 Nacos Config。两个服务必须位于同一个 Namespace 和 SHOP_GROUP,并使用有效账号访问 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> 中。
<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>订单服务的依赖片段如下。
<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>库存服务的依赖片段如下。
<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:
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: trueinventory-service/src/main/resources/application.yml:
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 的配置:
inventory:
limit: 5这份配置不要求控制台输出。验证标准是库存服务能启动,并且后续接口返回的 limit 为 5;如果配置读取失败,应先检查 Namespace ID、Group、账号权限和 Nacos 地址,而不是先改业务代码。
实现库存与订单服务
库存服务读取动态阈值,并用 @RefreshScope 让配置变更进入当前 Bean。以下两个 Java 文件依赖本节的 Maven 与 YAML 配置,不单独运行。
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);
}
}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 使用服务名查找实例。
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);
}
}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) {
}
}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> 替换为实际值;密码不要写进仓库。
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预期输出:
<TIME> ... Started InventoryApplication ...另一个终端设置同样变量后启动订单服务:
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预期输出:
<TIME> ... Started OrderApplication ...请求订单服务,确认 Feign 已通过注册中心找到库存服务:
curl -s "http://127.0.0.1:8080/orders/check?sku=sku-1&count=2"预期输出:
{"sku":"sku-1","requested":2,"available":true,"limit":5}随后把 Nacos 中 inventory-service.yaml 的 inventory.limit 改为 1 并发布,不重启任何服务,再执行同一请求:
curl -s "http://127.0.0.1:8080/orders/check?sku=sku-1&count=2"预期输出:
{"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,说明业务调用、服务发现、动态配置、环境隔离和鉴权已经形成一条可重复验证的闭环。