Ribbon 在 Zuul 1.x 网关中的负载均衡应用

3. 配置文件 (application.yml)

server:
  port: 8080

spring:
  application:
    name: zuul-gateway
  eureka:
    client:
      service-url:
        defaultZone: http://localhost:8761/eureka/
      fetch-registry: true
      register-with-eureka: true
    instance:
      prefer-ip-address: true

zuul:
  routes:
    user-service:
      path: /api/users/**
      serviceId: user-service
    order-service:
      path: /api/orders/**
      serviceId: order-service
  host:
    connect-timeout-millis: 10000
    socket-timeout-millis: 60000

ribbon:
  ConnectTimeout: 10000
  ReadTimeout: 60000
  MaxAutoRetries: 0
  MaxAutoRetriesNextServer: 1
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RoundRobinRule

注意：若未使用 Eureka，需手动配置 ribbon.listOfServers。serviceId 对应注册中心的服务名称。

实现一个简单的用户服务

为了测试负载均衡，创建一个名为 user-service 的后端服务。

1. 创建 User Service

package com.example.userservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class UserServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }

    @GetMapping("/users")
    public String getUsers() {
        return "User Service Response from instance: " + getHostname();
    }

    private String getHostname() {
        try {
            return java.net.InetAddress.getLocalHost().getHostName();
        } catch (Exception e) {
            return "Unknown Host";
        }
    }
}

2. 配置文件 (application.yml)

server:
  port: 8081

spring:
  application:
    name: user-service
  eureka:
    client:
      service-url:
        defaultZone: http://localhost:8761/eureka/
      fetch-registry: true
      register-with-eureka: true
    instance:
      prefer-ip-address: true
      instance-id: ${spring.application.name}:${server.port}

启动两个不同端口的实例（如 8081 和 8082），即可验证负载均衡效果。

测试与验证

启动 Eureka Server、多个 user-service 实例及 zuul-gateway 后，访问 http://localhost:8080/api/users。每次请求可能会返回不同实例的主机名，表明 Ribbon 成功进行了轮询。

Ribbon 负载均衡策略详解

Ribbon 内置了多种策略，可通过配置切换。

1. RoundRobinRule（轮询）

默认策略，依次选择实例。

ribbon:
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RoundRobinRule

2. RandomRule（随机）

随机选择实例。

ribbon:
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RandomRule

3. WeightedResponseTimeRule（加权响应时间）

响应时间越短权重越高。

ribbon:
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.WeightedResponseTimeRule

4. BestAvailableRule（最空闲）

选择并发请求数最少的实例。

ribbon:
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.BestAvailableRule

5. RetryRule（重试）

先轮询，失败后重试其他实例。

ribbon:
  NFLoadBalancerRuleClassName: com.netflix.loadbalancer.RetryRule

自定义策略

实现 com.netflix.loadbalancer.IRule 接口可定制逻辑。

package com.example.zuulribbon.config;

import com.netflix.loadbalancer.AbstractLoadBalancerRule;
import com.netflix.loadbalancer.Server;
import java.util.List;
import java.util.concurrent.ThreadLocalRandom;

public class CustomLoadBalancerRule extends AbstractLoadBalancerRule {
    @Override
    public Server choose(Object key) {
        com.netflix.loadbalancer.ILoadBalancer lb = getLoadBalancer();
        if (lb == null) return null;
        List<Server> servers = lb.getAllServers();
        if (servers.isEmpty()) return null;
        int index = ThreadLocalRandom.current().nextInt(servers.size());
        return servers.get(index);
    }

    @Override
    public void initWithNiwsConfig(com.netflix.client.config.IClientConfig clientConfig) {}
}

配置方式同上，指向自定义类路径。

超时与重试机制

分布式环境中网络波动常见，合理配置能增强健壮性。

ribbon:
  ConnectTimeout: 10000   # 连接超时
  ReadTimeout: 60000      # 读取超时
  MaxAutoRetries: 0       # 同一实例重试次数
  MaxAutoRetriesNextServer: 1 # 下一实例重试次数

高级特性与最佳实践

1. 自定义 Ribbon 配置

可为特定服务单独配置，例如为 user-service 设置更短的超时时间。

2. 服务降级与熔断

Ribbon 本身不提供熔断，建议结合 Hystrix 使用。

3. 服务健康检查

Ribbon 自动过滤不健康实例，依赖服务发现组件状态。

4. 请求头传递

默认传递所有 Header，可通过 zuul.sensitiveHeaders 排除敏感信息。

zuul:
  sensitiveHeaders: Cookie,Set-Cookie

性能优化与监控

• 缓存与预热: 合理配置实例列表刷新时间。
• 监控指标: 使用 Micrometer 收集负载均衡指标。
• 日志记录: 开启 DEBUG 级别日志调试行为。

logging:
  level:
    com.netflix.loadbalancer: DEBUG

总结与展望

Ribbon 在 Zuul 1.x 中的应用提升了网关的负载均衡能力。虽然 Zuul 1.x 存在阻塞式 I/O 的性能瓶颈，但理解其原理对维护旧系统及学习负载均衡概念依然重要。

优势：配置简单、策略灵活、生态成熟。 劣势：性能受限、社区活跃度下降、功能不如新一代网关丰富。

对于新项目，建议优先考虑基于 Netty 和 Reactor 的 Spring Cloud Gateway；对于现有系统，可逐步规划迁移。

参考链接：

• Netflix Zuul GitHub
• Spring Cloud Netflix Documentation