Loona Automation 标志Loona 开发者工具
首页 › 参考资料

HTTP 状态代码参考

简而言之: 日常开发中重要的所有状态代码——每个代码的含义、使用时机,以及陷阱(401 vs 403、302 vs 307)——可在您输入时筛选。
🔒 按设计保证隐私: 一切都在此设备上的您的浏览器中运行。您的输入从不上传到服务器。
代码名称含义
100继续客户端应继续发送请求正文
101切换协议协议升级被接受(例如升级到 WebSocket)
200OK请求成功——默认的成功响应
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内容过大请求正文超过服务器限制
414URI 过长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)。

相关开发者工具

把本工具嵌入您的网站 — 免费

把本工具添加到您自己的网站或博客——它完全免费,无需注册,并且始终显示最新版本。复制下面的代码,粘贴到您希望工具出现的页面位置。在嵌入下方保留那一行小小的 “Powered by Loona Automation” 署名,有助于让本工具保持免费 — 但您可以自由地设置它的样式或删除它;无论哪种方式工具都能工作。