Nginx中API配额需协同限流、响应体大小约束与连接管理：用limit_req_zone按IP限频，排除OPTIONS预检；通过proxy_buffers和proxy_read_timeout控制响应体积与超时；配合limit_conn和keepalive_timeout管理并发连接。
在 Nginx 中对 API 接口设置合理的请求响应配额，核心是控制“单位时间内的请求数”与“单次响应的数据量”，而非笼统限制“接口调用次数”。它需要结合限流（rate limiting）、响应体大小约束、连接数管理三方面协同配置，且必须区分真实业务请求与预检（OPTIONS）请求。
按 IP 或用户维度做请求频率限制
使用 limit_req_zone 定义配额规则，推荐以 $binary_remote_addr 为基础键值，兼顾精度与内存开销：
- 在 http 块中定义共享内存区： limit_req_zone $binary_remote_addr zone=api_limit:10m rate=20r/s;
- 在 location /api/ 下启用该限制： limit_req zone=api_limit burst=30 nodelay;（允许突发 30 次，不延迟排队）
- 为避免 OPTIONS 预检被限流干扰，需排除它： map $request_method $limit_key { default $binary_remote_addr; OPTIONS ""; }，再基于 $limit_key 定义 zone
限制单次响应体大小，防止资源耗尽
后端返回过大的 JSON 或文件流会拖慢 Nginx 缓冲与传输，可通过 proxy_buffer 和 client_max_body_size 协同控制：
- 设置代理缓冲区上限（防后端返回超大响应）： proxy_buffering on; proxy_buffers 8 128k;（共 8 个缓冲区，每个 128KB） proxy_busy_buffers_size 256k;
- 若 API 明确只返回轻量数据（如状态码+小 JSON），可设硬性上限： client_max_body_size 1m;（此为请求体限制，常用于上传；响应体无直接指令，靠缓冲与超时间接约束）
- 搭配超时控制更稳妥： proxy_read_timeout 15;（后端响应慢即断开，避免挂起连接）
控制并发连接与连接生命周期
防止瞬时大量连接挤占资源，尤其在高 QPS 场景下：
- 全局 worker 连接上限（events 块）： worker_connections 4096;（根据系统 ulimit 调整）
- 单个客户端最大并发连接数（可选）： limit_conn_zone $binary_remote_addr zone=conn_limit:10m; limit_conn conn_limit 10;（同一 IP 最多 10 个活跃连接）
- 缩短空闲连接保持时间： keepalive_timeout 15 10;（15 秒 keep-alive，10 秒后续请求复用超时）
响应头与预检请求的配额感知处理
配额策略需对浏览器友好，尤其是跨域场景下不能因限流导致预检失败：
- OPTIONS 请求必须绕过所有限流和代理逻辑，直接返回 204： if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin *; return 204; }
- 在限流触发时返回明确提示（非默认 503）： limit_req_status 429;（配合自定义错误页或 JSON 提示）
- 通过响应头告知客户端当前配额状态（需后端配合）： Nginx 本身不生成 X-RateLimit-Remaining 等头，但可透传后端返回的这类头，确保前端能感知余量
