limit_conn_status用于自定义连接限流触发时的HTTP状态码，仅支持http/server块，默认503，推荐设为429；需Nginx≥1.13.12，可配合error_page返回友好提示。
limit_conn_status 是 Nginx 中用于自定义连接数限制被触发时返回的 HTTP 状态码，它必须配合 limit_conn 指令使用，且只能在 http 或 server 块中配置。
基本用法与位置要求
该指令不能写在 location 块内，仅支持出现在 http 或 server 上下文中。默认值为 503（Service Temporarily Unavailable），你可以改为其他标准状态码，如 429（Too Many Requests）以更准确表达限流语义。
- 推荐使用
429，符合 RFC 6585，便于客户端识别是限流而非服务故障 - 不能设置为 1xx、2xx、3xx 或非标准码（如 600），Nginx 启动时会报错
- 若同时配置了多个
limit_conn规则，只要任一触发，就返回此处设定的状态码
完整配置示例
以下是在 server 块中限制单 IP 并返回 429 的典型写法：
http {
limit_conn_zone $binary_remote_addr zone=addr:10m;
server {
listen 80;
server_name example.com;
limit_conn_status 429;
limit_conn addr 10;
location /api/ {
proxy_pass http://backend;
}
}
}
注意：limit_conn_zone 必须在 http 块定义，而 limit_conn_status 和 limit_conn 可放在 server 或 location（但后者不支持 limit_conn_status）。
常见误区与调试提示
如果修改了 limit_conn_status 却未生效，检查以下几点：
- 确认 Nginx 版本 ≥ 1.13.12（该指令从此版本起正式支持）
- 确保没有在更外层（如另一个 server 或 http 块）重复定义并覆盖了你的设置
- 用
curl -I直接测试触发限流的请求，观察响应头中的Status行，而非仅依赖浏览器自动重定向或前端提示 - 日志中不会单独记录因限流产生的状态码变更，需结合
error_log级别为info或更高，查看是否有 “limiting connections” 类提示
搭配 error_page 实现友好提示
仅改状态码不够直观，可结合 error_page 返回自定义响应体：
limit_conn_status 429;
error_page 429 /429.html;
location = /429.html {
internal;
root /usr/share/nginx/html;
}
这样用户收到 429 状态的同时，还能看到清晰的提示页面，不影响 API 客户端解析状态码。
