HTTP 状态码入门：从 404 到 502 的日常排查

日常打开一个网页时，最先看到的往往不是内容，而是一串数字：404、500、502。这些数字是服务器给浏览器的一句简短回答，叫做 HTTP 状态码。它由三位数字组成，第一位数字说明大类，后两位再细分原因。学会按大类先定位，再按具体数字缩小范围，排查时就能少走很多弯路。

先看第一位数字，定大类

状态码一共分为五类。1xx 表示请求已被接收，还在继续处理，日常浏览中很少直接看到。2xx 表示成功，最常见的是 200，意思是请求已经成功处理。3xx 表示重定向，浏览器需要再去另一个地址拿内容，例如 301 是永久搬家，302 是临时换地方。4xx 表示客户端出了问题，例如地址写错、没有权限。5xx 表示服务端出了问题，即使请求本身没有错，服务器也没有办法正常返回结果。

先判断大类很重要。看到 4xx，先检查自己这一侧：地址、参数、登录状态和请求方式。看到 5xx，先不要急着改自己的代码，而是确认服务端、上游服务和网关是否正常。方向错了，再细的排查也是白费力气。

404：找不到资源，先确认地址

404 是最常见的状态码，意思是服务器收到了请求，但找不到对应的资源。常见原因有四种：地址拼错、资源已经被删除或改名、路由没有注册、部署后静态文件没有同步。排查时可以先把地址复制到浏览器里直接访问，排除前端拼接参数的问题；再对照接口文档或路由表，确认路径和方法是否一致；最后看服务端日志，确认请求是不是真的到达了目标服务，而不是在网关层就被拦住了。

需要注意的是，404 不等于服务器坏了。它恰恰说明网络是通的，服务器也在工作，只是没有这个资源。如果是自己开发的接口，重点检查路由配置；如果是访问别人的页面，先确认链接是否过期，或者资源是否已经下线。

401 和 403：没登录与没权限要分开

401 表示没有提供有效的身份凭证，或者凭证已经过期，解决办法通常是重新登录、刷新令牌，或者检查请求头里有没有带上正确的 Authorization。403 表示身份已经确认，但没有权限访问这个资源，例如普通用户去访问管理员接口，或者账号没有开通对应功能。这时重新登录没有用，需要确认账号权限、角色配置和资源归属。

把两者分开，可以避免一种常见误区：明明是权限不足，却反复退出重登；或者明明是令牌过期，却去找管理员开权限。看清数字，再决定找谁、改什么。

400：请求本身有问题

400 表示服务器看不懂这个请求，常见原因是参数缺失、参数类型不对、JSON 格式错误，或者请求方法不对。排查时先看接口返回的错误信息，很多服务会在正文里写明哪一个字段有问题；再用抓包工具或控制台对比实际发出的请求和文档要求，重点检查必填字段、枚举值和日期格式。如果是自己写的代码，逐字段核对往往比猜测更快。

500：服务端内部出错，看日志

500 是一个比较笼统的状态码，意思是服务端处理请求时发生了未预期的错误。它可能来自代码异常、数据库连接失败、配置错误，或者依赖的服务不可用。作为调用方，能做的通常是记录请求时间、请求路径和返回内容，然后反馈给服务端同学；作为服务端开发，则要第一时间查应用日志和异常堆栈，确认是最近一次发布引入的问题，还是外部依赖先出了问题。

不要把 500 当成一个具体原因，它只是一个起点。没有日志的 500，很难定位；有完整请求标识和时间的 500，排查效率会高很多。

502：网关没有拿到有效响应

502 的全称是错误网关，意思是作为网关或代理的服务器，从上游服务器那里没有收到有效的响应。常见场景是：后端服务已经停止、上游服务正在重启、服务地址配置错误，或者上游响应超时。排查时可以先确认后端进程是否在运行，再检查网关到上游的网络和地址配置，最后看上游的启动日志和健康检查状态。

502 和 500 的区别值得记住：500 是服务端自己处理时出错，502 是中间的网关没能从上游拿到结果。看到 502，先看上游是不是活着；看到 500，先看处理请求的服务自身有没有异常。

一套可复用的排查顺序

遇到状态码问题，可以按下面这个顺序走：第一步，看第一位数字定大类，区分是客户端问题还是服务端问题。第二步，确认是单个地址出问题，还是所有接口都出问题，前者多半是路由或资源问题，后者多半是服务或网络问题。第三步，复现并记录：请求地址、请求方法、关键参数、发生时间和返回正文。第四步，对照日志：前端看控制台和网络面板，后端看应用日志和网关日志。第五步，只改一个变量再复测，避免同时改多个配置，让结果无法归因。

最后提醒一点：状态码只是线索，不是结论。同样是 404，可能是地址错了，也可能是资源下线了；同样是 502，可能是服务停了，也可能是配置指错了地址。把状态码、请求信息和日志放在一起看，才能从数字走到真正的原因。养成这个习惯后，下次再看到 404 到 502，就不再是面对一串陌生的数字，而是一条清晰的排查路线。