OneTools在线工具

HTTP 状态码参考

1xx
1xx 信息响应(4)

100Continue
等待客户端发送请求体。
101Switching Protocols
服务器已同意更换协议。
102Processing
服务器正在处理请求,但尚无响应可用。
WebDAV
103Early Hints
服务器在最终的HTTP消息前返回部分响应头。

2xx
2xx 成功(10)

200OK
HTTP请求成功的标准响应。
201Created
请求已完成,并导致创建了新资源。
202Accepted
请求已被接受处理,但处理尚未完成。
203Non-Authoritative Information
请求成功,但内容已被转换代理修改。
204No Content
服务器成功处理了请求,但不返回任何内容。
205Reset Content
服务器指示重新初始化发送此请求的文档视图。
206Partial Content
由于范围标头,服务器只传送资源的一部分。
207Multi-Status
消息体包含多个子请求的XML多状态码。
WebDAV
208Already Reported
DAV绑定的成员已被全部枚举。
WebDAV
226IM Used
服务器已满足资源的GET请求。

3xx
3xx 重定向(9)

300Multiple Choices
表示资源有多个可供客户端选择的选项。
301Moved Permanently
请求资源的URL已永久更改。
302Found
请求资源的URL已临时更改。
303See Other
响应可以通过另一个URI使用GET方法获取。
304Not Modified
自If-Modified-Since指定的版本以来,资源未被修改。
305Use Proxy
请求的资源只能通过代理访问。
306Switch Proxy
不再使用。原意是要求后续请求使用代理。
307Temporary Redirect
请求应使用另一个URI重复,但方法不能更改。
308Permanent Redirect
当前及所有后续请求都应使用另一个URI重复。

4xx
4xx 客户端错误(29)

400Bad Request
由于客户端错误,服务器无法处理请求。
401Unauthorized
需要身份验证,但验证失败或未提供。
402Payment Required
保留供将来使用。最初用于数字支付系统。
403Forbidden
客户端没有访问内容的权限。
404Not Found
服务器无法找到请求的资源。
405Method Not Allowed
资源不支持该请求方法。
406Not Acceptable
服务器无法生成符合可接受值列表的响应。
407Proxy Authentication Required
客户端必须先通过代理进行身份验证。
408Request Timeout
服务器等待请求时超时。
409Conflict
请求与服务器的当前状态冲突。
410Gone
请求的内容已被永久删除。
411Length Required
请求未指定内容的长度,而资源需要此信息。
412Precondition Failed
服务器不满足请求中指定的某个前提条件。
413Payload Too Large
请求的大小超过了服务器的处理能力。
414URI Too Long
提供的URI过长,服务器无法处理。
415Unsupported Media Type
服务器不支持请求数据的媒体格式。
416Range Not Satisfiable
Range标头中指定的范围无法满足。
417Expectation Failed
Expect标头指定的预期条件无法满足。
418I'm a Teapot
服务器拒绝冲泡咖啡,因为它是一个茶壶。愚人节玩笑。
421Misdirected Request
请求被发送到无法产生响应的服务器。
422Unprocessable Entity
请求格式正确但因语义错误而无法处理。
423Locked
正在访问的资源已被锁定。
WebDAV
424Failed Dependency
由于先前请求失败,当前请求也失败。
WebDAV
425Too Early
服务器不愿冒险处理可能被重放的请求。
426Upgrade Required
客户端应切换到不同的协议。
428Precondition Required
源服务器要求请求必须是有条件的。
429Too Many Requests
用户在给定时间内发送了过多请求。
431Request Header Fields Too Large
由于标头字段过大,服务器不愿处理该请求。
451Unavailable For Legal Reasons
由于法律原因,该资源不可用。

5xx
5xx 服务器错误(11)

500Internal Server Error
遇到意外条件时的通用错误消息。
501Not Implemented
服务器不支持完成请求所需的功能。
502Bad Gateway
服务器收到来自上游服务器的无效响应。
503Service Unavailable
服务器当前无法处理该请求。
504Gateway Timeout
服务器未及时收到上游服务器的响应。
505HTTP Version Not Supported
服务器不支持请求中使用的HTTP版本。
506Variant Also Negotiates
透明内容协商导致循环引用。
507Insufficient Storage
服务器无法存储完成请求所需的表示。
WebDAV
508Loop Detected
服务器在处理请求时检测到无限循环。
WebDAV
510Not Extended
需要更多扩展才能让服务器完成请求。
511Network Authentication Required
客户端需要进行身份验证才能获得网络访问权限。

HTTP 状态码参考 - 完整指南与分类搜索

所有 HTTP 状态码的完整参考列表,从 1xx 信息响应到 5xx 服务器错误。按分类浏览状态码,支持按编号或名称搜索,一键复制。包含 WebDAV 状态码。颜色编码便于快速识别。网站开发者、API 设计人员和系统管理员的必备参考。

HTTP 状态码参考的核心功能

📋 完整状态码参考

浏览全部 63 个 HTTP 和 WebDAV 状态码,按 1xx 信息响应到 5xx 服务器错误五个分类组织。

🔍 实时搜索

按状态码编号、名称、描述或类别搜索。输入时结果即时筛选。

🎨 颜色编码分类

每个类别有独特颜色:成功为绿色,重定向为琥珀色,错误为红色。便于视觉快速扫描。

🏷️ 分类筛选标签

使用筛选标签在 1xx、2xx、3xx、4xx 和 5xx 分类之间快速切换,并显示各分类状态码数量。

📝 一键复制

单击即可将任意状态码编号复制到剪贴板。适用于文档编写和代码注释。

🌐 WebDAV 支持

除所有标准 HTTP 状态码外,还包含 WebDAV 专用状态码,清晰标识。

📱 响应式与无障碍

在桌面端和移动端均可使用。状态码以简洁的网格布局显示,自适应任何屏幕尺寸。

🔒 无需上传数据

这是一个静态参考页面。所有数据预加载在浏览器中,无需向服务器发送请求。

什么是 HTTP 状态码?

HTTP 状态码是 Web 服务器在响应 HTTP 请求时返回的三位数字代码。它们指示请求是否已成功处理、是否已重定向或是否发生了错误。

状态码分为五类:1xx(信息响应)、2xx(成功)、3xx(重定向)、4xx(客户端错误)和 5xx(服务器错误)。每个状态码都有 HTTP 规范(RFC 7231 及相关 RFC)定义的标准含义和描述。

为什么要使用 HTTP 状态码参考?

  • 网站开发:在构建或调试 HTTP API 和 Web 应用程序时快速查询状态码
  • API 设计:为 REST 和 GraphQL API 响应选择正确的状态码
  • 调试排错:理解服务器、代理和 CDN 返回的错误响应
  • 技术文档:为技术文档引用准确的状态码描述
  • 学习提升:学习 HTTP 状态码的含义和正确使用方法

如何使用 HTTP 状态码参考

步骤操作
1按分类浏览
使用筛选标签按分类查看状态码:从 1xx 信息响应到 5xx 服务器错误。
2搜索状态码
在搜索框中输入状态码编号、名称或描述,即时查找特定状态码。
3查看说明
每个状态码卡片显示编号、标准名称、说明和协议类型。
4复制状态码
点击任意状态码上的复制图标,将状态码编号复制到剪贴板。
💡 专业提示: 设计 API 时,尽量使用最具体的状态码。例如,资源不存在时返回 404,永久删除的资源返回 410,客户端没有权限时返回 403。

常用场景

🌐 API 开发

在构建和编写 RESTful 和 GraphQL API 文档时参考正确的状态码。

🔧 服务器问题调试

在服务器日志、错误消息或 API 响应中查找不熟悉的状态码。

📝 技术写作

在 API 文档、教程和技术文章中使用准确的状态码描述。

🎓 学习 HTTP 协议

学习每个 HTTP 状态码分类及具体状态码的含义和正确用法。

🛡️ 安全审计

验证应用返回适当的状态码,避免通过错误响应泄露信息。

⚡ 性能监控

在监控面板中理解 5xx 和 4xx 状态码,快速识别服务器问题和客户端错误。

HTTP 状态码常见问题

4xx 和 5xx 状态码有什么区别?

4xx 状态码表示客户端错误 — 请求包含无效语法、未授权访问或由于客户端问题无法完成。例如 404 Not Found 表示资源不存在。5xx 状态码表示服务器错误 — 服务器因内部问题无法处理有效请求,如 500 Internal Server Error 或 503 Service Unavailable。关键区别在于问题是出在客户端请求还是服务器的处理能力。

最常见的 HTTP 状态码是什么?

200 OK 是成功请求中最常见的 HTTP 状态码。在错误方面,404 Not Found 是最广为人知的状态码。在现代 Web 应用中,301/302 重定向状态码也非常常见。在服务器端,500 Internal Server Error 是最通用的服务器错误码。根据网络流量分析,约 70-80% 的请求返回 2xx 状态码,5-10% 返回 3xx 重定向,5-15% 返回 4xx 客户端错误,1-5% 返回 5xx 服务器错误。

HTTP 状态码可以自定义吗?

标准 HTTP 状态码由 IANA 和 RFC 规范定义,但某些情况下可以使用自定义状态码。不过不建议这样做,因为客户端、代理和浏览器可能无法识别自定义码。标准状态码已涵盖几乎所有常见场景。某些应用内部使用非标准码,但与外部客户端通信时应始终映射为标准码。HTTP 规范为特定分类(1xx-5xx)保留了状态码范围,建议使用最合适的现有状态码,而非创建自定义码。

418 I'm a Teapot 状态码是什么?

418 I'm a Teapot 状态码是 1998 年 4 月 1 日发布的 RFC 2324(超文本咖啡壶控制协议)中定义的愚人节玩笑。它表示服务器拒绝煮咖啡,因为它是一个茶壶。虽然它是一个官方注册的 HTTP 状态码,但并不用于实际场景。一些开发者和框架将其作为彩蛋或用于测试目的。它已成为 HTTP 规范中最知名的幽默元素之一。

如何处理 301 和 302 重定向?

当资源永久移动到新 URL 时使用 301 Moved Permanently。搜索引擎会更新索引到新 URL 并停止爬取旧的。当重定向是临时的(如维护期间或 A/B 测试)时使用 302 Found(或 307 Temporary Redirect)。搜索引擎会继续索引原始 URL。对于现代应用,考虑使用 308 Permanent Redirect(保留请求方法)和 307 Temporary Redirect(保留请求方法)作为 301 和 302 的更明确替代方案。

通过我们的参考掌握 HTTP 状态码

OneTools Online 的 HTTP 状态码参考提供了所有标准 HTTP 和 WebDAV 状态码的完整、可搜索、颜色编码的指南。无论您是构建 API 的网站开发者、调试服务器问题的系统管理员,还是学习 HTTP 协议的学生,此参考都能帮您快速查找和理解任何状态码。凭借实时搜索、分类筛选和一键复制功能,它是日常 Web 开发工作的完美助手。