对负载均衡后特定接口做并发连接管控，核心是用变量构造精准限流键、limit_conn_zone建共享内存计数器、location中绑定生效；推荐用map归一化路径，如报表接口映射为report_export等统一标识，再定义zone=report_conn:5m，最后在location ^~ /api/report/中配置limit_conn report_conn 8及多维度限流。
要对负载均衡后特定接口做并发连接管控，核心是用变量构造精准的限流键，再通过 limit_conn_zone 建立共享内存计数器，最后在对应 location 中绑定生效。它不依赖请求体或响应内容，只在 TCP 连接建立时计数，轻量且稳定。
选对变量构造接口维度的限流键
接口路径是天然识别依据，但直接用 $uri 或 $request_uri 有风险：
-
$uri不带查询参数，适合路径固定、参数走 body 或 header 的接口（如/api/report/export） -
$request_uri含完整 URL，若含时间戳、随机数等高频变动参数，会导致 key 爆炸，快速耗尽共享内存 - 更稳妥的做法是用
map提前归一化：把多个相似路径映射为统一标识
例如针对报表类接口：
map $uri $report_endpoint {~^/api/report/export "report_export";
~^/api/report/preview "report_preview";
~^/v2/reports/"report_v2";
default "";
}
定义共享内存 zone 并预估容量
在 http{} 块中定义，必须放在所有 server 块之前：
5MB 内存约支持 16 万个独立键（每个键平均占 32 字节），足够覆盖数十个核心接口。若接口数量较多或需长期保留状态，可升至 10m。
注意：zone 名称（如 report_conn）后续会被 limit_conn 引用，必须全局唯一、语义清晰。
在 location 中启用并绑定限制策略
仅对明确的目标路径启用，避免误伤其他流量。推荐使用 ^~ 前缀匹配，兼顾性能与准确性：
limit_conn report_conn 8;
limit_conn_status 429;
limit_conn_log_level warn;
proxy_pass http://report_backend;
}
这里 8 表示所有匹配该前缀的请求，任意时刻最多维持 8 个 TCP 连接（HTTP/2 单连接多 stream 仍计为 1）。
若需叠加客户端维度防护，可在同一 location 内再加一行：
limit_conn ip_report 3;
效果：任一 IP 对报表接口最多开 3 个连接，同时所有 IP 访问该接口总连接数不超过 8 个。
配合 keepalive 和日志提升实际可用性
空闲 keepalive 连接会持续占用配额，建议显式缩短超时：
keepalive_timeout 15;加上以下两行，便于监控和前端处理：
-
limit_conn_status 429：返回标准限流状态码，比默认 503 更易被前端识别和重试 -
limit_conn_log_level warn：触发时记 warn 日志，方便告警系统捕获，又不淹没 error 日志
