服务注册与分布式协调 / 系统课时
用负载均衡调用下游服务
用负载均衡调用下游服务
这一课把固定的 host:port 调用改成逻辑服务名调用:订单服务只写 inventory-service,由 Spring Cloud LoadBalancer 从 Nacos 的实例列表中选择可用节点并发出 HTTP 请求。完成后,你可以通过连续请求观察调用落到不同实例。
学习目标
- 使用
@LoadBalanced让 HTTP 客户端识别逻辑服务名 - 说明 Nacos 服务发现与客户端负载均衡各自承担的职责
- 用多实例输出验证请求确实经过负载均衡
先建立可被选择的下游实例
下游服务必须以相同的 spring.application.name 注册到 Nacos。下面的控制器把当前端口放进响应,便于确认请求最终命中了哪一个实例。代码是 Spring Boot 应用中的片段示例,依赖上下文中的 Web Starter 与 Nacos Discovery Starter。
@RestController
public class InventoryController {
@Value("${server.port}")
private int port;
@GetMapping("/inventory/{id}")
public Map<String, Object> inventory(@PathVariable long id) {
// 返回实例端口,专门用于观察负载均衡结果。
return Map.of(
"itemId", id,
"available", true,
"servedBy", port
);
}
}下游服务至少需要如下配置。<HOST> 替换为 Nacos 所在主机;如果 Nacos 在本机,可写 127.0.0.1:8848。
spring:
application:
name: inventory-service
cloud:
nacos:
discovery:
server-addr: <HOST>:8848先在终端 A 启动第一个实例:
mvn spring-boot:run -Dspring-boot.run.arguments="--server.port=8081"预期结果
应用启动成功,并以 inventory-service 注册;当前实例端口为 8081。再在终端 B 启动第二个实例:
mvn spring-boot:run -Dspring-boot.run.arguments="--server.port=8082"预期结果
应用启动成功,并以 inventory-service 注册;当前实例端口为 8082。让调用方使用逻辑服务名
调用方需要 Spring Cloud LoadBalancer。依赖版本应由项目使用的 Spring Cloud 与 Spring Cloud Alibaba BOM 统一管理,避免手工拼接不兼容版本。
<!-- 片段示例:放入现有 Spring Boot 项目的 dependencies。 -->
<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-loadbalancer</artifactId>
</dependency>为 RestTemplate 增加 @LoadBalanced 后,URL 中的主机部分不再要求是 DNS 可解析的真实主机名,而可以是服务 ID。下面是调用方 Spring Boot 应用中的片段示例,依赖已有的 Web Starter。
@Configuration
public class LoadBalancerConfig {
@Bean
@LoadBalanced
public RestTemplate restTemplate(RestTemplateBuilder builder) {
return builder.build();
}
}
@RestController
public class OrderController {
private final RestTemplate restTemplate;
public OrderController(RestTemplate restTemplate) {
this.restTemplate = restTemplate;
}
@GetMapping("/orders/{id}/stock")
public Map<?, ?> stock(@PathVariable long id) {
// inventory-service 是 Nacos 中的逻辑服务名,不是固定地址。
return restTemplate.getForObject(
"http://inventory-service/inventory/" + id,
Map.class
);
}
}调用方仍需指向同一个 Nacos,并使用自己的服务名:
spring:
application:
name: order-service
cloud:
nacos:
discovery:
server-addr: <HOST>:8848请求是怎样找到真实实例的
@LoadBalanced 并不会让 Nacos 直接代理 HTTP 流量。实际过程是调用方先按 inventory-service 查询可用实例,Spring Cloud LoadBalancer 再从实例列表中选择一个地址,最后由 RestTemplate 对选中的真实 host:port 发起请求。

因此,Nacos 负责回答“有哪些实例可用”,LoadBalancer 负责回答“这一次选哪个实例”。如果把 URL 写回 http://127.0.0.1:8081/...,就绕过了这套按服务名选择实例的流程。
连续请求验证分流
启动 order-service 后连续请求同一个接口。下面假设调用方端口是 8080,且没有自定义负载均衡策略。
for i in 1 2 3 4; do
curl -s http://localhost:8080/orders/1/stock
echo
done预期输出
{"itemId":1,"available":true,"servedBy":8081}
{"itemId":1,"available":true,"servedBy":8082}
{"itemId":1,"available":true,"servedBy":8081}
{"itemId":1,"available":true,"servedBy":8082}默认策略通常表现为轮询,因此多次请求会在健康实例间切换;若实例列表变化、你覆盖了 LoadBalancer 策略,实际顺序可能不同。验证重点不是固定的先后顺序,而是响应中的 servedBy 能出现多个已注册实例。
当调用端只依赖服务名、不再持有具体 IP 和端口后,实例扩容、缩容或迁移都不需要修改调用代码;这正是客户端负载均衡替代固定地址的核心价值。