运维 / Nginx

四个状态码,四个方向

先看状态码,再看错误日志,最后才动配置——顺序反了会改一堆无关的地方。

四类状态码日志优先定位顺序
本篇要点
  • 先看 access.log 的状态码,再看 error.log 的具体行。
  • 502 多为后端没起或端口错,504 多为后端处理太慢。
  • 413 是请求体超限,403 是文件权限或目录索引被禁。

先看两个日志

access.log 告诉你「返回了什么码、请求打到了哪个 upstream」,error.log 告诉你「为什么」。两条日志按时间对照,比猜快得多。默认路径在 /var/log/nginx/ 下,容器里要进容器看或挂载出来。

四类对照

状态码含义第一步查什么
502网关收到无效响应后端进程是否在跑、端口是否对
504网关等待超时后端处理耗时、proxy_read_timeout
413请求体过大client_max_body_size
403拒绝访问文件权限、目录索引、deny 规则

502 与 504

  • 502 三因:后端没启动、端口写错、SELinux 或权限挡住连接
  • 504 两因:后端确实慢(数据库、外部接口),或超时阈值设得太小
  • 两者都先 curl 一下 upstream 地址,确认后端本身能通

502 与 504 的分界很清楚:后端根本没应答是 502,应答了但太慢是 504。分不清时看 error.log 里是 connection refused 还是 timeout。

413 与 403

413 只需要改一个参数:client_max_body_size 调到实际需要的上限,同时确认后端(PHP、Node)自己的限制也放开了。只改 Nginx 往往还是失败,因为后端有独立的上限。

403 的常见原因是文件权限:Nginx 进程读不到目录,或目录缺少执行位。另一个原因是 root 指错了路径,请求落在一个不存在且不允许列目录的位置。

改完怎么验

nginx -t && systemctl reload nginx

先 -t 检查语法,通过再 reload。reload 是平滑重载,不会断开现有连接;restart 会。改配置期间优先用 reload,出问题还能回滚。

看 error.log 时先找 upstream 字段:它写明请求转给了哪个后端地址、耗时多少、失败原因。没有 upstream 说明 Nginx 自己就拒了(静态文件、权限、规则),有 upstream 再把问题交给后端日志。这一条能把「Nginx 的问题」和「后端的问题」分开,省掉一半来回猜。

常见问题

改了配置没生效?

先确认 reload 成功,再看是否有多个 server 块命中同一域名(默认取第一个)。

502 但后端日志正常?

看是否连到了错误的端口,或容器网络与宿主不通。

能直接改超时解决 504 吗?

能缓解,但根因是后端慢。把超时调大只是把问题推后。

日志里一堆扫描请求怎么办?

按状态码过滤后再看,404 与 400 的扫描噪声会淹没真正的问题。