访客打开网站,看到的可能是 404、500、502、503 这类报错页面。不同状态码对应不同环节的问题,先判断卡在哪一层,再去查对应服务,比盲目重启或改配置高效得多。这篇按常见状态码讲清 Web 报错的排查思路:404、500、502、503 分别是什么原因,从 Web 服务、后端程序、数据库到配置怎么逐层定位。

4xx 一般是请求本身的问题:地址不存在、权限不足或被拒绝;5xx 一般是服务器端的问题:程序报错、后端没响应或服务暂时不可用。前面掉线排查篇讲过机器连不上的网络层问题,这篇聚焦站点能连上、但页面返回报错的应用层情况。
排查前先确认报错是全站都有,还是只有个别页面;是一直报错,还是访问时偶发。范围不同,问题环节也不同:全站报错多在 Web 服务、后端或数据库层面,个别页面报错多在对应程序或资源路径。
404 表示请求的路径在服务器上不存在。常见原因:文件或页面路径写错、链接指向的资源已移动或删除、站点目录绑定的根目录不对、后端路由没有匹配上。前面 Nginx 篇讲过站点目录绑定,404 先核对实际文件位置和 Web 服务配置的根目录是否一致。
静态资源(图片、样式、脚本)出现 404,检查资源路径大小写、相对路径和文件是否真的上传到位;动态页面 404,检查后端路由规则和重写配置。访问日志里的 404 条目可以帮你集中看出哪些路径在被请求(前面访问日志篇讲过日志查看)。
500 是服务器内部错误,通常由后端程序抛出异常引起:代码报错、依赖缺失、配置读取失败、数据库连接异常、文件权限不足等。500 的具体原因要靠程序错误日志判断,Web 页面上往往只显示通用报错页。
排查时先看后端程序和 Web 服务的错误日志,定位报错堆栈和出错文件;常见诱因包括刚改完代码或配置、依赖版本变化、数据库连不上、上传目录不可写。前面进程服务篇讲过日志查看,配置管理篇讲过开发生产配置区分,这些环节都可能触发 500。

502 通常出现在有反向代理的架构里:Web 服务作为网关收到请求,但转发给后端程序时,后端没有正常返回。常见原因:后端程序没启动或已崩溃、监听端口不对、反代配置里的后端地址或端口填错、后端处理超时。前面端口规划篇讲过内部端口与入口映射,502 要重点核对反代转发目标是否正确。
排查顺序:先确认后端进程是否在运行、是否监听在预期端口;再核对反代配置里的后端地址、端口和路径;最后看后端日志是否有启动失败、依赖报错或超时。后端重启后,502 通常随之恢复。
503 表示服务暂时无法处理请求,常见原因:服务正在重启或维护、后端进程挂掉未拉起、服务器资源(CPU、内存、连接数)打满导致无法响应、限流或维护页面生效。前面监控篇讲过资源占用瓶颈,503 要结合当时的 CPU、内存和负载一起看。
如果是资源打满引起的 503,先看是哪个进程占用过高,必要时临时恢复服务再排查根因;如果是服务未运行,检查开机自启和崩溃恢复配置(前面开机自启篇讲过)。偶发 503 多与并发突增或资源不足有关,长期出现要考虑扩容。
建议按访问链路逐层走:先看 Web 服务是否在运行、站点配置和根目录是否正确;再看后端程序进程状态、监听端口和错误日志;接着检查数据库能否连接、表和配置是否正常;最后核对防火墙、反代转发和资源占用。每定位一层,用日志和实际状态验证,不要跳过证据直接改。
改配置或重启服务前留好备份,一次只改一处,改完用实际页面和接口验证。遇到自己无法判断的报错,把状态码、报错时间、对应页面和错误日志留存好,再联系服务商协助(前面售后 SLA 篇讲过工单保障)。
站点并发和后端程序较多、容易出现资源不足类报错时,可以参考 RackNerd:月付 2.24 美元起,采用 KVM 虚拟化,全球 20 个数据中心可选,服务商是 Inc.5000 上榜企业;业务长大、需要整机级承载时,也有独立服务器,月付 139 美元起。具体配置以所选机型和官方说明为准。
想对照自己业务规模挑选稳定承载的机器,可以看 RackNerd 这条线,入口放这,点红色链接进去核对:
几句实在话:4xx 多是请求或路径问题,5xx 多是服务端问题;404 查路径、根目录和路由;500 看后端错误日志;502 查后端进程、监听端口和反代转发;503 查服务状态和资源占用;按链路逐层排查,用日志验证,一次只改一处。
总的来讲,Web 报错排查的关键是“按状态码定位环节、按链路逐层验证”。熟悉常见状态码对应的原因和排查路径,遇到页面打不开时就能快速缩小范围,先恢复访问,再彻底解决根因。

游戏软件