Nginx日志中哪些错误码最常见

Nginx日志中最常见的错误码

总体概览

• 在Nginx访问日志中，最常见的错误码主要集中在客户端错误4xx与网关/上游错误5xx两类。下面按出现频率由高到低的常见程度梳理，并给出典型成因与排查要点（含Nginx特有状态码说明）。

最常见的4xx错误码

• 404 Not Found：请求的资源不存在或路径错误，是最常见的前端可见错误之一。
• 403 Forbidden：服务器理解请求但拒绝执行，常见于目录无索引且未开启autoindex、文件/目录权限不足等。
• 400 Bad Request：请求语法不合法，典型诱因包括请求头/URI过大、Cookie过大、HTTP/1.1 的 Host 头缺失或非法、将明文 HTTP 发到 HTTPS 端口等。
• 405 Method Not Allowed：对静态资源使用了不被允许的方法（如对静态文件使用 POST）。
• 413 Request Entity Too Large：请求体超过 client_max_body_size 限制，常见于文件上传。
• 414 URI Too Long：请求 URI 超过服务器可处理长度。
• 499 Client Closed Request（Nginx扩展）：客户端在服务器返回前主动关闭连接，多与客户端超时设置相关。

最常见的5xx错误码

• 500 Internal Server Error：服务器内部错误，常见于后端脚本异常（如 PHP/Lua 语法错误）、资源限制（如打开文件数、内存）、磁盘空间不足等。
• 502 Bad Gateway：作为网关/代理从上游收到无效响应，常见于上游进程未启动（如 php-fpm 未运行）、进程崩溃或返回不合法响应。
• 503 Service Unavailable：服务暂不可用，多见于过载、维护或上游全部不可用。
• 504 Gateway Timeout：上游在设定超时内未返回响应，通常与 proxy_read_timeout、proxy_send_timeout 或 fastcgi_read_timeout 配置相关。

Nginx特有状态码与上游错误

• 495 SSL Certificate Error / 496 SSL Certificate Required：客户端证书校验失败或未提供证书（Nginx 扩展）。
• 497 HTTP Request Sent to HTTPS Port：明文 HTTP 请求被发送到 HTTPS 端口（Nginx 扩展）。
• 499 Client Closed Request：客户端提前关闭连接（Nginx 扩展）。
• 上游连通性与协议类错误常见于 error.log，例如：
  • “connect() failed (111: Connection refused) while connecting to upstream” 表示上游拒绝连接（如服务未启动/端口不对）。
  • “upstream prematurely closed connection while reading response header from upstream” 表示上游提前关闭连接。

快速排查要点

• 判断错误来源：在日志中结合 $upstream_status 与 $upstream_addr 判断是 Nginx 直接返回（如 400/403/404/405）还是上游返回（如 502/503/504）。
• 针对 4xx：
  • 404/403：核对资源路径、文件权限与 index 配置；目录浏览需求开启 autoindex on。
  • 400：检查请求头/URI 长度、Cookie 体积、Host 头合法性，避免 HTTP/HTTPS 端口混用。
  • 405：避免对静态资源使用 POST 等不被允许的方法。
  • 413/414：适当增大 client_max_body_size，并确保与上游（如 PHP 的 post_max_size/upload_max_filesize）一致。
  • 499：结合客户端超时与 proxy_read_timeout 等参数评估是否需优化超时或启用 proxy_ignore_client_abort（需评估业务影响）。
• 针对 5xx：
  • 500：优先查 error.log 与后端日志（语法错误、资源限制、磁盘空间）。
  • 502/503/504：确认上游存活与健康（进程、端口、负载），按需调整 proxy_read_timeout、proxy_send_timeout、fastcgi_buffers 等超时与缓冲参数。