资源配额模型基础概念

在微服务网关架构中，资源配额是保障系统稳定性与多租户公平性的核心机制。Kong 网关通过 Rate Limiting 和 Quota 插件实现了对 API 调用频率与总量的精细化控制。理解配额模型的基础概念，是后续故障排查与工程实践的前提。

什么是资源配额（Rate Limiting & Quota）

资源配额是指对客户端在特定时间窗口内能够发起的 API 请求次数或数据量进行限制的机制。Kong 提供了两种互补的配额控制方式：

配额与限流的区别

虽然“配额”和“限流”在日常用语中常被混用，但在 Kong 网关的工程语境下，两者有明确的职责边界：

• 限流（Rate Limiting）：关注瞬时速率，核心目标是防止系统被短时间内的请求洪峰压垮。限流算法（如令牌桶、滑动窗口）通常具有“平滑”特性，允许短时突发但限制平均速率。
• 配额（Quota）：关注累计总量，核心目标是管理资源预算和计费。配额用尽后，客户端必须等待下一个周期或申请扩容，无法通过“等待几秒”来恢复。

配额模型的核心要素

无论是 Rate Limiting 还是 Quota，其底层模型都围绕三个核心要素构建：时间窗口、计数、上限。理解这三者的关系是配置和排查配额问题的关键。

1. 时间窗口（Time Window）

时间窗口定义了计数重置的周期。Kong 支持多种窗口粒度：

• 秒（second）：最细粒度，用于高频限流。
• 分钟（minute）：常用粒度，平衡精度与性能。
• 小时（hour）：适合配额类控制。
• 天（day）：长期预算管理。
• 月（month）：计费周期对齐。
• 年（year）：极少使用，用于特殊订阅。

2. 计数（Counter）

计数是配额模型中的状态变量，记录在时间窗口内已消耗的请求次数。Kong 使用 Redis 或本地内存作为计数存储后端：

3. 上限（Limit）

上限定义了在时间窗口内允许的最大请求次数。上限可以是单一值，也可以是分层值（如免费用户 1000 次/小时，付费用户 10000 次/小时）。

配额模型在 Kong 中的实现路径

Kong 的配额模型通过插件配置与运行时计数引擎协同工作。以下是一个典型的 Rate Limiting 插件配置示例：

# 为特定路由配置速率限制
curl -X POST http://localhost:8001/routes/{route_id}/plugins \
  --data "name=rate-limiting" \
  --data "config.minute=100" \
  --data "config.hour=5000" \
  --data "config.policy=redis" \
  --data "config.redis_host=redis-cluster.example.com" \
  --data "config.redis_port=6379"

该配置表示：每分钟最多 100 次请求，每小时最多 5000 次请求，计数存储在 Redis 集群中。当任一窗口的计数达到上限时，Kong 返回 429 Too Many Requests。