- 先看 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 的扫描噪声会淹没真正的问题。