HTTP 状态码速查

输入状态码看它到底是什么意思、通常是哪一环出的问题——排查线上报错时最省时间的一步。

等待…
常用:502 网关拿到无效响应 · 504 网关等上游超时 · 403 有权但被拒 · 429 限流 · 413 请求体过大

常见问题

401 和 403 有什么区别?

401 是「不知道你是谁」,没登录、token 过期、签名不对;403 是「知道你是谁,但你没有这个权限」。所以 401 应该引导重新登录,403 只能提示权限不足。两者混用时排查方向会完全跑偏。

502 和 504 该怎么排查?

两者都是网关(nginx)和上游服务之间的问题。502 是网关拿到无效响应,说明后端可能根本没启动、端口没监听、返回了非 HTTP 内容;504 是网关等上游超时,说明后端活着但处理太慢。先用 curl 内网直连后端端口确认服务是否存活,再看慢查询或第三方接口耗时。

304 是错误吗?

不是,304 表示资源没有变化,让客户端继续用本地缓存。如果你改了文件页面却没更新,先在浏览器开发者工具里看这个请求是不是 304,多半是 CDN 或浏览器缓存导致的。

429 被限流后该怎么办?

看响应头里的 Retry-After,按它等待后再重试,并做指数退避。共享 IP 时可能被同 IP 的其他调用牵连。作为接口方,限流要给出明确额度和配额说明,否则用户只会觉得服务不稳定。