如何通过 limit_req 指令实现针对不同 API 版本路径的差异化负载均衡流控-Nginx-PHP中文网

可通过limit_req指令结合多维度键实现按API版本路径独立限流，如/v1/users与/v2/users各自拥有独立令牌桶，支持正则提取、header/query版本识别及细粒度资源级控制。

如何通过 limit_req 指令实现针对不同 api 版本路径的差异化负载均衡流控

可以通过 limit_req 指令结合 limit_req_zone 的多维度键（如 $uri、$args、自定义变量）实现按 API 版本路径（如 /v1/users、/v2/users）独立限流，无需额外模块或外部服务。

用 URI 路径前缀定义不同版本的限流区域

Nginx 允许基于正则提取版本号或路径段构造唯一 key，从而为各版本分配独立令牌桶。例如：

在 http 块中定义两个 zone：

limit_req_zone $v1_key zone=v1_api:10m rate=10r/s;
limit_req_zone $v2_key zone=v2_api:10m rate=50r/s;

map $uri $v1_key {
    ~^/v1/      $uri;
    default      "";
}
map $uri $v2_key {
    ~^/v2/      $uri;
    default      "";
}

这样 /v1/xxx 请求只进入 v1_api 区域，/v2/xxx 只进入 v2_api 区域，互不影响。

支持细粒度路径匹配（如 /v1/users vs /v1/orders）

若需对同一版本下不同资源进一步区分，可组合使用 $uri 和 $request_method，或提取二级路径：

用 map 提取主路径段：~^/v1/([^/]+) $v1_resource $1;
定义 zone：limit_req_zone "$v1_resource:$request_method" zone=v1_res:10m rate=20r/s;
在 location 中应用：limit_req zone=v1_res burst=40 nodelay;

此时 GET /v1/users 和 POST /v1/users 视为不同流控单位，/v1/orders 则走另一套计数逻辑。

兼容带查询参数或灰度标识的版本路径

当版本通过 header（如 X-API-Version: v2）或 query（如 ?version=v2）传递时，仍可统一归类：

用 map 统一映射版本标识：map $arg_version $api_ver { "v2" "v2"; default "v1"; }
或读取 header：map $http_x_api_version $api_ver { "v2" "v2"; default "v1"; }
再构造 zone key：limit_req_zone "$api_ver:$uri" zone=api_by_ver:10m rate=30r/s;

该方式能自动适配 header/query/路径混合的版本识别策略，保持限流逻辑集中可控。

避免跨版本误共享与突发流量穿透

关键注意事项：

确保每个 limit_req_zone 的 key 不重叠——不要用纯 $uri 或 $binary_remote_addr 作为所有版本共用 key
对未匹配任何版本的请求（如 /legacy/），建议显式拒绝或降级：return 404 "API version not supported";
启用 burst 和 nodelay 时注意：nodelay 会立即拒绝超限请求，适合强限流；若需平滑排队，去掉 nodelay 并调大 burst