调接口时最常见的困惑不是报错本身,而是「这个码到底谁的问题」。这份速查收录 62 个 HTTP 状态码,按 1xx 到 5xx 分类,每个都给出英文短语、中文名、一句话含义、典型出现场景,以及默认是否可缓存。支持按数字、英文或中文搜索,也整理了 401 与 403、502 与 504、301 与 302 这类容易混的对照说明,排查时可以直接定位到责任方。
搜或筛
直接输 502、Not Found 或「未找到」都能命中;也可以点顶部分类只看 4xx 或 5xx。
展开看场景
点卡片展开典型场景与缓存属性,判断是客户端参数问题、网关问题还是服务端异常。
查排查对照
底部「常见排查」把成对易混的码放在一起比较,点关联码可以直接跳到对应条目。
先看是谁超时。502 是网关从上游收到了无效响应(应用崩了、端口没监听、返回了非 HTTP 内容),504 是网关等上游超时(应用还活着但处理太慢)。前者去查进程与端口,后者去查慢查询、下游依赖和超时配置。
401 是「你没告诉我是谁」——缺 token、token 过期、格式不对,通常带 WWW-Authenticate 头,客户端应该重新认证。403 是「我知道你是谁,但你不能做这个」——权限不足、IP 被禁、资源属主不匹配,重新登录也没用。
是的。301 表示永久迁移,搜索引擎会把权重转移到新地址并替换索引;302 表示临时跳转,原地址仍保留在索引里。域名更换、URL 结构永久调整用 301,A/B 测试、临时维护页用 302 或 307。
不一定。503 和 504 通常可重试,配合 Retry-After 与指数退避;500 说明代码抛了异常,盲目重试可能放大故障;501 是方法未实现,重试永远不会成功。另外只有幂等请求(GET、PUT、DELETE)适合自动重试,POST 要先确认服务端有没有做幂等键。