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

用负载均衡调用下游服务

用负载均衡调用下游服务

这一课把固定的 host:port 调用改成逻辑服务名调用:订单服务只写 inventory-service,由 Spring Cloud LoadBalancer 从 Nacos 的实例列表中选择可用节点并发出 HTTP 请求。完成后,你可以通过连续请求观察调用落到不同实例。

学习目标

  • 使用 @LoadBalanced 让 HTTP 客户端识别逻辑服务名
  • 说明 Nacos 服务发现与客户端负载均衡各自承担的职责
  • 用多实例输出验证请求确实经过负载均衡

先建立可被选择的下游实例

下游服务必须以相同的 spring.application.name 注册到 Nacos。下面的控制器把当前端口放进响应,便于确认请求最终命中了哪一个实例。代码是 Spring Boot 应用中的片段示例,依赖上下文中的 Web Starter 与 Nacos Discovery Starter。

java
@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。

yaml
spring:
  application:
    name: inventory-service
  cloud:
    nacos:
      discovery:
        server-addr: <HOST>:8848

先在终端 A 启动第一个实例:

bash
mvn spring-boot:run -Dspring-boot.run.arguments="--server.port=8081"

预期结果

text
应用启动成功,并以 inventory-service 注册;当前实例端口为 8081。

再在终端 B 启动第二个实例:

bash
mvn spring-boot:run -Dspring-boot.run.arguments="--server.port=8082"

预期结果

text
应用启动成功,并以 inventory-service 注册;当前实例端口为 8082。

让调用方使用逻辑服务名

调用方需要 Spring Cloud LoadBalancer。依赖版本应由项目使用的 Spring Cloud 与 Spring Cloud Alibaba BOM 统一管理,避免手工拼接不兼容版本。

xml
<!-- 片段示例:放入现有 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。

java
@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,并使用自己的服务名:

yaml
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,且没有自定义负载均衡策略。

bash
for i in 1 2 3 4; do
  curl -s http://localhost:8080/orders/1/stock
  echo
done

预期输出

text
{"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 和端口后,实例扩容、缩容或迁移都不需要修改调用代码;这正是客户端负载均衡替代固定地址的核心价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

用负载均衡调用下游服务

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

登录哪都通