nginx-503

Nginx 503 Service Temporarily Unavailable 的定位

现象

请求返回 503 Service Temporarily Unavailable。可能是所有后端不可用、被限流、连接数打满，或 Nginx 处于维护状态。

快速定位

tail -f /var/log/nginx/error.log
nginx -T | grep -nE 'upstream|limit_req|limit_conn|return 503|proxy_next_upstream'
ss -lntp | grep ':<backend-port>'
curl -v http://<backend>:<port>/health

常见根因

1. upstream 中所有后端都不可用或被健康检查摘除。
2. limit_req/limit_conn 触发限流。
3. 后端连接池、worker 或文件描述符耗尽。
4. 配置了 return 503 或维护页面。
5. DNS 解析失败或 upstream 地址变化。

修复

• 先看 error.log 的具体原因，区分后端不可用和限流。
• 恢复后端，确认端口、健康检查和防火墙。
• 调整限流阈值或客户端重试策略，避免误伤正常流量。
• 扩容 worker/连接池，检查 worker_connections 和系统 fd 限制。
• 维护场景用明确的维护页和 Retry-After。
• 配置 proxy_next_upstream 时注意幂等性，避免重复写操作。

相关命令

• nginx — 配置与日志
• ss — 后端端口
• curl — 验证后端