HTTP 状态码
60 条常用 HTTP 状态码速查:含义、中文解释、分类过滤一表打尽;排查接口报错不再翻文档。
| CODE | PHRASE | 中文含义 |
|---|
>_ 使用指南 · GUIDE
60 条常用 HTTP 状态码速查表:每条含状态码、英文名、中文解释与处置建议,支持按分类过滤(2xx 成功 / 3xx 重定向 / 4xx 客户端错误 / 5xx 服务端错误)。排查接口报错时不用再翻文档——搜 401/403/429,含义和「该查哪里」一表打尽。
适合贴在工位当手册用,也适合新手系统了解 HTTP 协议的响应语义。纯静态速查表,本地渲染。
>_ 常见问题 · FAQ
Q1 · 404 是什么意思?
Not Found:服务器找不到请求的资源——URL 写错、资源被删除、路由没配置。与它常被混淆的是 410(Gone,明确表示已永久删除)。前端调试时 404 首先检查请求路径拼写和代理配置,而不是怀疑服务器挂了。
Q2 · 401 和 403 有什么区别?
401 = 未认证(不知道你是谁:没登录、token 过期无效);403 = 已认证但无权限(知道你是谁,但你不够格)。排查方向完全不同:401 查登录态/token 传递,403 查权限配置/角色分配。收到 403 去反复重新登录是典型的方向性错误。
Q3 · 502 和 504 有什么区别?
都在反向代理(Nginx 网关)后面:502 Bad Gateway = 后端应用挂了或返回非法响应(进程崩溃、端口没起);504 Gateway Timeout = 后端活着但响应超时(慢查询、死锁、外部依赖卡住)。502 查应用进程,504 查耗时——两个不同的排查方向。
Q4 · 301 和 302 重定向有什么区别?
301 = 永久重定向(浏览器与搜索引擎会缓存新地址,SEO 权重转移);302 = 临时重定向(不缓存,权重不转移)。换域名、改 URL 结构用 301;活动页临时跳转、登录后回跳用 302。用反了的后果:本该临时的跳转被浏览器缓存,想改回来都难。
Q5 · 418 是什么?还有哪些有趣的非标准状态码?
418 I'm a teapot(我是茶壶)是 1998 年愚人节玩笑,被部分服务实际用作反爬虫彩蛋。类似的还有 425(Too Early)、451(因法律原因不可用)。速查表收录了这些「梗码」便于阅读他人代码时理解——生产系统自己用还是要 stick 标准码,避免网关不识别。