客户发来截图,说我们网站打不开,页面上一行白字:502 Bad Gateway。本地打开一切正常。
这种情况先别改代码。502 是网关拿不到上游响应,问题在服务端到应用之间的链路,跟前端一点关系没有。
先看第一位数字
HTTP 状态码的第一位决定了责任方,这是排查的起点:
- 4xx:请求方的问题。地址错、没权限、参数不合法。
- 5xx:服务端的问题。代码崩了、上游挂了、超时了。
客户看到 4xx,先让对方检查链接和登录状态;看到 5xx,才轮到你查服务器。
几个高频状态码查什么
403 Forbidden
服务器认出了你,但拒绝给。常见原因:目录权限配置、防盗链、WAF 规则拦了、请求头里的 User-Agent 被判为爬虫。看响应头里有没有 server 和拦截提示,能判断是 Nginx 挡的还是应用挡的。
404 Not Found
路径不存在。注意区分大小写、结尾斜杠、有没有多余参数。部署后突然 404 的,先确认静态文件有没有真的上传上去。
502 Bad Gateway
网关(Nginx、CDN、负载均衡)连不上后面的应用。排查顺序:应用进程在不在 → 端口通不通 → 应用是不是启动到一半崩了 → 上游地址配置对不对。
502 有个典型特征:刷新几次偶尔能打开。这说明后端时好时坏,多半是资源耗尽(内存、连接数)而不是彻底挂掉。
504 Gateway Timeout
连上了但不响应。通常是应用处理超时——慢查询、外部接口卡住、任务死循环。看应用日志里有没有长耗时请求,比看网关日志有用。
怎么判断是 CDN 还是源站
看响应头。server 是 Nginx 还是 CDN 厂商的标识,via、x-cache 这类字段能看出是否经过缓存层。
最快的区分办法是绕开 CDN 直连源站 IP(用 hosts 临时指向)。直连正常、走 CDN 报错,问题就在 CDN 配置或回源。
给非技术同事的描述模板
让他们截图时顺手说三件事,排查能快一半:
- 页面上的状态码是多少。
- 是所有人都打不开,还是只有他打不开。
- 换手机流量(不走公司网络)还报不报。
第三条特别有用。只有他一个人打不开,八成是本地 DNS 缓存、公司代理或者浏览器插件的问题。
常用工具
状态码含义查HTTP状态码查询;想确认站点此刻是否可访问,用网站HTTP状态检测;怀疑网络不通的,PING连通性检测先跑一遍;如果报的是证书错误,SSL证书信息检查能看有效期和证书链是否完整。
最后一句话:状态码只是线索,不是结论。同一个 502,可能是内存爆了,也可能是配置写错了一个端口号,得看日志才能定。