Nginx不能直接通过HTTP状态码实现限流，需依赖limit_req模块配合map提取路径等条件定义限流区域，并通过limit_req_status自定义返回状态码（如429），结合burst和nodelay控制突发流量。
在 Nginx 中，**不能直接通过 HTTP 状态码实现限流**。状态码是响应结果，而限流是请求处理前的控制行为。真正起作用的是 limit_req 模块配合自定义条件（如请求路径、header、IP 等），再结合状态码（如 503）反馈限流结果。
用 limit_req 按路径限流
核心是利用 limit_req_zone 定义限流区域，并通过 map 提取请求路径作为 key，实现“不同路径不同速率”：
- 先用
map提取路径前缀（如/api/v1/、/health），映射到不同限流标识 - 在
limit_req_zone中基于该标识定义速率（如每秒 10 个请求） - 在
location块中用limit_req引用该 zone，触发限流逻辑
示例配置：
map $request_uri $limit_key {
~^/api/v1/ api_v1;
~^/health health_check;
default default_zone;
}
limit_req_zone $limit_key zone=by_path:10m rate=10r/s;
server {
location / {
limit_req zone=by_path burst=20 nodelay;
proxy_pass http://backend;
}
}
限流后返回指定状态码
限流触发时，默认返回 503 Service Temporarily Unavailable。可通过 limit_req_status 修改为其他状态码（如 429 Too Many Requests）：
- 添加
limit_req_status 429;到 server 或 location 块中 - 注意：该指令只影响被拒绝的请求，不改变正常响应的状态码
- 前端或监控系统可据此区分业务失败与限流拒绝
按路径动态调整限流强度
更精细的控制可通过多个 limit_req_zone + 多个 map 实现分层限流：
- 对高优先级路径（如
/login）设宽松速率（如 100r/s） - 对资源密集型路径（如
/report/export）设严格速率（如 2r/s） - 用
limit_req的burst和nodelay控制突发容忍度
例如：limit_req zone=export_zone burst=5 nodelay; 允许短时突增但不排队延迟。
验证与调试技巧
限流是否生效，不能只看状态码，要结合日志和实际行为判断：
- 开启
limit_req_log_level warn;，在 error log 中查看限流记录 - 用
curl -I多次请求目标路径，观察响应头和状态码变化 - 注意：缓存、CDN 或上游代理可能干扰限流效果，确保 Nginx 是第一道入口
不复杂但容易忽略细节。
