一、基础知识
一次网页请求往往要经过很多层:浏览器 → CDN → 负载均衡或反向代理(如 Nginx)→ 应用服务器 → 数据库。状态码就是某一层对这次请求的「结论」,先看数字属于哪一类,能立刻缩小范围。
- 4xx(客户端类):服务器收到并理解了请求,但没让它通过。403 属于这类。
- 5xx(服务端类):服务器这边出了问题。502、503、504 属于这类。
四个码的准确含义:
- 502 Bad Gateway:网关或代理从上游收到了「无效」的响应。比如上游直接断连、返回了不是 HTTP 的乱码、响应头格式错误。注意关键词是「收到了坏响应」。
- 503 Service Unavailable:服务临时不可用。常见于应用过载、正在维护,或负载均衡后端池里没有健康节点。
- 504 Gateway Timeout:网关在规定时间内没等到上游的响应。关键词是「等不到」。
- 403 Forbidden:服务器理解你的请求,但拒绝执行。通常和权限、目录访问、IP 限制、WAF 拦截有关。
一个非常重要的观念:状态码不一定来自你的应用。502/504 多半是网关层报的,403 可能是 Web 服务器、应用或安全设备报的。排查第一步永远是「先确定这是谁报的错」,而不是急着改代码。响应头里的 Server、Via、X-Cache 等字段能提供线索。
二、实操步骤
下面用 example.com 和文档地址 192.0.2.10 演示,命令可直接套用。
第 1 步:用 curl 看状态码和响应头。
curl -I https://example.com
curl -s -o /dev/null -w "HTTP=%{http_code} 总耗时=%{time_total}sn" https://example.com
%{http_code} 给出状态码,%{time_total} 给出总耗时,两者结合能初步判断是「立刻失败」还是「等超时才失败」。
第 2 步:拆开各阶段耗时,快速区分 502 和 504。
curl -s -o /dev/null -w "DNS=%{time_namelookup} 连接=%{time_connect} 首字节=%{time_starttransfer} 总=%{time_total}n" https://example.com
如果「首字节」时间很长然后报 504,说明网关确实在等上游;如果瞬间返回 502,多半是上游直接断连或返回了坏响应。
第 3 步:看是谁报的错。
curl -sSI https://example.com | grep -iE 'server|via|x-cache|retry-after'
出现 Retry-After 往往意味着 503 是维护/限流;出现 CDN 相关头,说明错误可能来自 CDN 节点而非源站。
第 4 步:查看网关错误日志(以 Nginx 为例)。
sudo tail -n 50 /var/log/nginx/error.log
502 常见关键字:upstream sent invalid header、connect() failed、Connection reset by peer。504 常见关键字:upstream timed out。这些关键字直接告诉你故障类型。
第 5 步:绕过网关直连上游,验证应用本身是否正常。
curl -v http://192.0.2.10:8080/health
如果直连返回正常,问题在网关到上游这一段;如果直连也失败,问题在应用或主机。
第 6 步:确认服务进程与监听端口。
ss -lntp | grep ':8080'
systemctl status your-app.service
第 7 步:针对 403,检查文件与目录权限。
ls -ld /var/www/html /var/www/html/index.html
namei -l /var/www/html/index.html
namei -l 能逐级显示路径上每一层的权限和属主,特别适合定位「某一级目录没有执行位 x」导致的 403。
三、关键细节
-
502 与 504 的分界线是「有没有收到响应」。收到但无效是 502,等不到是 504。这个区别决定了你该查「上游为什么返回乱码/断连」还是「上游为什么慢/超时」。
-
curl -v 里
HTTP/1.1 502可能出现多次。多次状态行通常来自-L跟随重定向、CONNECT 隧道的 200、100-continue 或认证挑战,并不代表链路上又多了一层代理。判断链路要结合Location、Via等响应头,不要用状态码出现的次数去推断代理层数。 -
超时是分层的:客户端超时、网关的读超时、应用自身超时。504 往往是这几者没对齐,比如客户端 30 秒超时、网关读超时 60 秒,用户先放弃了。
-
403 比 404「泄露」更多信息:403 说明资源存在但你没权限,404 表示「没有或故意藏着」。从安全角度看,这两者的选择有时是刻意设计。
-
Nginx 的
proxy_read_timeout等参数名和默认值可能随版本变化,本文不写死数值,请以官方文档为准,修改前先确认当前配置里实际写了什么。 -
偶发的 502 常和长连接有关:网关与上游的 keepalive 时间不匹配,复用的连接刚好被上游关闭,就会拿到一个断掉的响应。
四、常见错误
1. 报 502,但应用日志里完全没有这次请求
- 现象:网关日志有错误,应用日志安静。
- 原因:请求根本没到应用,卡在网关到上游这一段(上游端口错、进程挂了、连接被拒)。
- 修正:用 ss -lntp 确认端口在监听,用 curl 直连上游验证,再看网关日志里的 connect() failed 细节。
2. 报 504,就认定「上游代码太慢」
- 现象:只看状态码就改业务代码。
- 原因:可能是网关读超时设得过短,或上游连接池被耗尽、在排队。
- 修正:用 curl -w 看首字节耗时,检查连接池与超时配置,确认是「真慢」还是「配置太紧」。
3. 403 只改了文件权限,忘了属主和执行位
- 现象:chmod 644 之后仍然 403。
- 原因:Web 服务进程用户读不到文件,或某级目录缺少执行位 x。
- 修正:用 namei -l 逐级检查,确认属主/属组与目录的 x 位都正确。
4. 把 403 全归咎于 Nginx 配置
- 现象:反复改 Nginx 仍 403。
- 原因:实际是 WAF、云防护或 IP 黑名单在拦截。
- 修正:看响应头里是否有安全设备标识,用响应内容或厂商控制台确认拦截来源。
5. 502 偶发、重启后短暂恢复
- 现象:不是必现,过一会儿又来。
- 原因:keepalive 连接复用与上游超时不匹配,或上游域名解析发生波动。
- 修正:核对网关与上游的长连接超时设置;若上游用域名,确认解析稳定。
6. 后端池被健康检查摘空,返回 503
- 现象:所有请求都 503。
- 原因:健康检查失败把节点全摘掉了。
- 修正:检查后端健康状态与检查路径,确认检查用的端口/路径和应用实际一致。
五、排查方法
照这个顺序做,逐步收敛:
# 1. 确认状态码与耗时特征
curl -s -o /dev/null -w "HTTP=%{http_code} 首字节=%{time_starttransfer} 总=%{time_total}n" https://example.com
# 2. 确认是谁报的错
curl -sSI https://example.com | grep -iE 'server|via|x-cache|retry-after'
# 3. 看网关错误日志关键字
sudo tail -n 50 /var/log/nginx/error.log | grep -iE 'upstream|timeout|invalid|refused|reset'
# 4. 直连上游,隔离网关因素
curl -v http://192.0.2.10:8080/health
# 5. 确认进程与端口
ss -lntp | grep ':8080'
systemctl status your-app.service
# 6. 针对 403:逐级检查权限
namei -l /var/www/html/index.html
# 7. 必要时抓一次完整握手与响应
curl -v --max-time 10 https://example.com -o /dev/null
判断逻辑:立刻 502 查「上游断连/坏响应」;等超时 504 查「慢与超时配置」;503 查「后端是否健康、是否在维护」;403 查「权限与拦截来源」。先定位层,再深入该层。
六、注意事项
- 状态码只是症状,不是诊断书。同一个 502 可能是端口写错,也可能是上游崩溃,必须结合日志。
- 不同网关/框架归类不同:有的把上游超时算 504,有的算 502,具体以所用组件的官方文档为准。
- 修改超时要谨慎:盲目把超时调大可能让请求堆积、拖垮服务,应先找到真正的慢点。
- 重试要注意幂等:GET 可安全重试,带副作用的 POST 盲目重试可能造成重复操作。
- 版本差异:日志路径、配置参数名、默认超时值随发行版和版本变化,本文不写死,请以官方文档和当前实际配置为准。
免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。

评论
还没有评论,来说两句吧。