HTTP 状态代码参考
简而言之: 日常开发中重要的所有状态代码——每个代码的含义、使用时机,以及陷阱(401 vs 403、302 vs 307)——可在您输入时筛选。
🔒 按设计保证隐私: 一切都在此设备上的您的浏览器中运行。您的输入从不上传到服务器。
| 代码 | 名称 | 含义 |
|---|---|---|
| 100 | 继续 | 客户端应继续发送请求正文 |
| 101 | 切换协议 | 协议升级被接受(例如升级到 WebSocket) |
| 200 | OK | 请求成功——默认的成功响应 |
| 201 | 已创建 | 已创建一个新资源(典型的 POST 成功) |
| 202 | 已接受 | 已排队进行异步处理,尚未完成 |
| 204 | 无内容 | 成功,正文故意为空 |
| 301 | 永久移动 | 资源有了一个新的永久 URL——更新链接;SEO 权益会转移 |
| 302 | 已找到 | 临时重定向(历史上被滥用;见 303/307) |
| 303 | 查看其他 | 重定向到另一个 URL 的 GET(post/redirect/get) |
| 304 | 未修改 | 缓存副本仍然有效——通过 ETag/Last-Modified 重新验证 |
| 307 | 临时重定向 | 保留方法和正文的临时重定向 |
| 308 | 永久重定向 | 保留方法和正文的永久重定向 |
| 400 | 请求错误 | 服务器无法解析/理解请求 |
| 401 | 未授权 | 需要身份验证或验证失败(尽管名字如此,它的意思是未通过身份验证) |
| 403 | 禁止访问 | 无论是否通过身份验证,访问都被拒绝 |
| 404 | 未找到 | 此 URL 没有资源 |
| 405 | 方法不允许 | 此资源不支持该 HTTP 方法 |
| 406 | 不可接受 | 没有表示与 Accept 标头匹配 |
| 408 | 请求超时 | 客户端发送请求耗时过长 |
| 409 | 冲突 | 状态冲突,例如编辑冲突或重复创建 |
| 410 | 已消失(Gone) | 永久删除(比 404 更强——故意使用) |
| 411 | 需要长度(Length Required) | 需要 Content-Length 标头 |
| 413 | 内容过大 | 请求正文超过服务器限制 |
| 414 | URI 过长 | URL 超过服务器限制 |
| 415 | 不支持的媒体类型 | 请求的 Content-Type 不受支持 |
| 418 | 我是一个茶壶(I'm a Teapot) | RFC 2324 玩笑代码,偶尔用于拒绝煮咖啡 |
| 422 | 不可处理的内容 | 语法没问题,但语义未通过验证(API 特别喜欢这个) |
| 425 | 过早 | 服务器不愿意处理可能被重放的请求 |
| 429 | 请求过多 | 触发速率限制——退避,遵守 Retry-After |
| 500 | 内部服务器错误 | 通用服务器端故障 |
| 501 | 未实现 | 服务器不支持该功能 |
| 502 | 网关错误 | 代理/网关从上游收到了无效响应 |
| 503 | 服务不可用 | 过载或停机维护——通常是暂时的,可能携带 Retry-After |
| 504 | 网关超时 | 代理/网关等待上游时超时 |
| 505 | 不支持 HTTP 版本 | 请求中的 HTTP 版本不受支持 |
关于
状态码是服务器对每个响应的单数字摘要,按类别分组:1xx 信息性、2xx 成功、3xx 重定向、4xx 客户端出错、5xx 服务器出错。表格给出在职开发者实际遇到的代码,带在实践中重要的细微差别——401 尽管名字如此,含义是未认证;403 是拒绝,与登录无关;422 是 API 验证失败;429 要求退避。未列出的代码(1xx 和实验性代码的长尾)足够罕见,仅类别就告诉您如何处理它们。
常见问题
401 和 403 有什么区别?
401:我们不知道您是谁(请进行身份验证)。403:我们知道您是谁,但您仍然无权访问。
临时重定向用 302 还是 307?
307 会保留请求方法和正文;302 在历史上允许客户端把 POST 切换为 GET。新项目应使用 307(永久重定向则用 308)。