Higress 集群限流插件新增全局限流功能解析

在微服务架构中，API限流是保障系统稳定性的重要手段。Higress作为一款高性能的云原生网关，其集群限流插件近期进行了重要功能升级，新增了对整个路由的全局限流支持，为开发者提供了更灵活的流量控制方案。

全局限流功能背景

传统的集群限流插件通常要求开发者必须设置具体的限流规则才能生效，这在某些场景下显得不够灵活。例如，当开发者只需要对整个API路由设置一个统一的限流阈值时，现有的条件限流规则配置就显得过于复杂。

功能实现方案

Higress团队针对这一需求进行了架构升级，新增了global_threshold配置项，允许开发者直接对整个路由设置限流阈值。该配置支持多种时间维度的限流设置：

• 每秒请求数(query_per_second)
• 每分钟请求数(query_per_minute)
• 每小时请求数(query_per_hour)
• 每天请求数(query_per_day)

配置示例

全局限流配置示例如下：

rule_name: "global-route-limit"
show_limit_quota_header: true
rejected_code: 429
rejected_msg: "Global rate limit exceeded"
redis:
  service_name: "redis-cluster.example.com"
  service_port: 6379
  username: "admin"
  password: "******"
global_threshold:
  query_per_minute: 1000

这个配置表示整个路由每分钟最多允许1000次请求，超过此限制的请求将返回429状态码和指定的错误信息。

架构设计考量

在实现这一功能时，开发团队做了以下关键决策：

1. 互斥性原则：要求global_threshold配置与rule_items条件限流规则必须至少配置其中一项，但不能同时配置。这种设计保证了配置的清晰性和系统的可预测性。

2. 扩展性设计：虽然当前版本不支持全局限流和条件限流同时使用，但架构设计为未来可能的组合使用预留了扩展空间。

3. 性能优化：全局限流实现采用了与条件限流相同的高效Redis集群计数机制，确保在大流量场景下的性能表现。

技术实现细节

在底层实现上，全局限流功能与原有的条件限流共享核心限流算法，但在路由匹配阶段做了优化：

1. 当检测到global_threshold配置时，插件会跳过条件匹配阶段，直接进入全局计数器检查。

2. 计数器采用Redis的原子操作保证分布式环境下的准确性。

3. 限流头信息(show_limit_quota_header)在全局限流模式下同样有效，客户端可以获取当前的限流配额信息。

适用场景建议

全局限流功能特别适合以下场景：

1. 简单API保护：当API不需要区分用户或条件的精细限流时。

2. 快速上线：在开发初期，可以先设置全局限流快速实现基本保护。

3. 紧急熔断：当系统出现异常时，可以快速设置全局限流值进行熔断保护。

总结

Higress集群限流插件的这一升级，为开发者提供了从全局到条件的完整限流解决方案。全局限流功能的加入不仅简化了配置，也扩展了插件的适用场景，使得流量控制策略的制定更加灵活多样。对于需要简单有效保护API的场景，现在可以直接使用全局限流配置，而无需设置复杂的条件规则，这大大降低了使用门槛，提升了开发效率。