irule 是 ribbon 客户端负载均衡策略核心接口，需实现 choose() 和 setloadbalancer() 方法；自定义如权重轮询应继承 abstractloadbalancerrule，从 getreachableservers() 获取实例并读取元数据 weight；生效方式优先级为代码 > @ribbonclient > 配置文件；注意避免耗时操作、空列表检查及日志验证。

Ribbon 的 IRule 接口是实现客户端负载均衡策略的核心扩展点，自定义算法只需实现该接口并配置生效即可，关键在于理解规则触发时机和上下文数据结构。

IRule 的核心方法与执行逻辑

IRule 定义了两个关键方法：choose(Server) 用于从服务实例列表中选取一个目标节点，setLoadBalancer(ILoadBalancer) 用于注入负载均衡器实例。Ribbon 在每次发起 HTTP 请求前（如通过 RestTemplate 调用）会调用 choose()，传入当前已知的可用服务列表（由 ILoadBalancer 维护），你的实现需基于该列表返回一个 Server 实例。

编写自定义 IRule 实现类

以“权重轮询”为例（根据元数据中的 weight 值做加权选择）：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 继承 AbstractLoadBalancerRule 更方便，它已帮你处理空列表、null 判断等基础逻辑
• 在 choose() 中调用 getLoadBalancer().getReachableServers() 获取当前健康实例列表
• 遍历每个 Server，通过 server.getMetaInfo().getMetaData().get("weight") 提取权重（需 Eureka 注册时配置）
• 按权重累积计算随机偏移量，实现带权轮询或随机加权选择

让自定义规则生效的三种方式

配置优先级：代码 > @RibbonClient 注解 > 全局配置文件。

• 全局生效：在 Spring Boot 配置类中声明 @Bean 方法，返回你的 IRule 实例，不加 @Scope("prototype") 即可被所有 Ribbon 客户端复用
• 指定服务生效：使用 @RibbonClient(name = "user-service", configuration = UserRuleConfig.class)，并在 UserRuleConfig 中定义 IRule Bean
• 配置文件方式（不推荐）：在 application.yml 中写 user-service: ribbon: rule: com.example.WeightedRule，但要求该类有无参构造且 Spring 能扫描到

注意事项与调试技巧

自定义规则不是黑盒，可通过日志验证行为是否符合预期。

• choose() 方法会被高频调用，避免在其中做耗时操作（如远程调用、锁、复杂 IO）
• 务必检查 getReachableServers() 返回列表是否为空，防止 NPE；若为空可 fallback 到 getAllServers() 或抛出明确异常
• 调试时可在 choose() 开头打印服务列表大小和各实例 IP + 权重，快速定位注册中心数据是否同步正确
• Ribbon 2.7.x+ 已进入维护模式，新项目建议迁移到 Spring Cloud LoadBalancer，但存量系统仍广泛使用 IRule 扩展

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南