Nginx 的 limit_conn_status 仅能设置连接超限时的 HTTP 状态码（如 429），无法直接自定义响应体；需配合 error_page 指令映射到 internal location，并用 return 返回 JSON 或 HTML 内容。
Nginx 的 limit_conn_status 指令本身**不能直接自定义错误响应体内容**（比如返回 JSON 或 HTML），它只用于设置连接数超限时返回的 HTTP 状态码（默认是 503）。真正实现“自定义错误响应信息”，需要结合 error_page 和 location 块来重写响应体。
1. 正确配置 limit_conn_status 设置状态码
该指令必须放在 http、server 或 location 块中，且需配合 limit_conn 使用。例如：
http {
limit_conn_zone $binary_remote_addr zone=addr:10m;
<pre class="brush:php;toolbar:false;">server {
listen 80;
server_name example.com;
limit_conn addr 10;
limit_conn_status 429; # 超限时返回 429 Too Many Requests
location /api/ {
proxy_pass http://backend;
}
}}
2. 用 error_page 捕获并重定向到自定义响应位置
将指定状态码（如 429）映射到一个内部 location，由该 location 输出你想要的内容：
server {
# ... 上面的 limit_conn 配置保持不变
<pre class="brush:php;toolbar:false;"># 捕获 limit_conn 触发的 429 状态码
error_page 429 = @rate_limited;
location @rate_limited {
internal; # 确保只能内部跳转，禁止外部直接访问
add_header Content-Type "application/json; charset=utf-8";
return 429 '{"error":"Too many connections","code":429,"message":"You have exceeded the allowed concurrent connections."}';
}}
3. 可选：返回 HTML 页面或重定向到友好提示页
如果需要更丰富的提示，可返回静态 HTML 或重定向：
- 返回内联 HTML：
location @rate_limited {
internal;
add_header Content-Type "text/html; charset=utf-8";
return 429 '<!DOCTYPE html><html><body><h2>Connection limit exceeded</h2><p>Please try again later.</p></body></html>';
}- 或重定向到一个真实 HTML 文件（需确保该路径可被 Nginx 访问）：
location @rate_limited {
internal;
rewrite ^ /errors/429.html break;
}
location /errors/429.html {
internal;
root /usr/share/nginx/html;
}4. 注意事项与常见问题
-
status 码必须匹配：
limit_conn_status 429和error_page 429 = ...中的状态码要一致；Nginx 仅对显式设置的 status 生效，不会自动捕获未声明的码。 -
必须加
internal：防止用户绕过限流直接请求@rate_limited或错误页面路径。 - return 指令不支持变量插值：返回的字符串是静态内容，无法嵌入客户端 IP 或时间等动态信息（如需动态内容，需用 Lua 或后端服务处理）。
-
避免循环：确保
@rate_limitedlocation 不再触发限流逻辑（比如不要在里面再配limit_conn）。
