3. Kong 内置 Rate Limiting 插件详解：插件工作原理、配置参数

Rate Limiting（速率限制）是 API 网关最核心的流量控制手段之一。Kong 内置的 Rate Limiting 插件基于滑动窗口算法实现，能够在分布式或单节点环境下精确限制客户端在指定时间窗口内的请求次数，防止后端服务被突发流量冲垮。

3.1 插件工作原理

Rate Limiting 插件的核心逻辑可概括为：在每个时间窗口内，为每个消费者（或 IP、凭证等）维护一个计数器，当请求到达时递增计数器，若计数器超过阈值则拒绝请求。其工作流程如下：

1. 请求到达：客户端请求进入 Kong，插件根据 config.limit_by 确定计数对象（消费者、IP、凭证等）。
2. 计数器查询：从后端存储（本地内存、Redis 或集群共享存储）读取当前时间窗口的计数器值。
3. 阈值判断：若当前计数器值 < 配置的速率上限，则允许请求通过，并将计数器 +1；否则返回 429 Too Many Requests。
4. 窗口滑动：时间窗口按秒、分、时、天、月、年自然滑动，旧窗口数据自动过期。

3.2 配置参数详解

Rate Limiting 插件的配置参数分为时间窗口参数、计数维度参数和存储策略参数三大类。以下逐一说明：

3.2.1 时间窗口参数

插件支持 6 个独立的时间窗口，每个窗口可单独设置请求上限。这些参数可以任意组合使用，系统会同时检查所有已配置的窗口：

3.2.2 计数维度参数：config.limit_by

config.limit_by 决定以什么维度对请求进行分组计数，即“限制谁”。可选值及含义如下：

3.2.3 存储策略参数：config.policy

config.policy 决定计数器数据的存储方式，直接影响限流的准确性和性能：

3.3 配置示例

以下是一个完整的 Rate Limiting 插件配置示例，通过 Admin API 创建：

curl -X POST http://localhost:8001/routes/{route_id}/plugins \
  --header "Content-Type: application/json" \
  --data '{
    "name": "rate-limiting",
    "config": {
      "second": 5,
      "minute": 200,
      "hour": 5000,
      "limit_by": "consumer",
      "policy": "redis",
      "redis_host": "192.168.1.100",
      "redis_port": 6379,
      "redis_password": "securepass",
      "redis_database": 0,
      "redis_timeout": 2000,
      "fault_tolerant": true,
      "hide_client_headers": false
    }
  }'

3.4 常见故障排查