HTTP 状态码大全

查询 HTTP 状态码含义(1xx–5xx)。

共 54 条

状态码英文分类说明
100Continue1xx 信息继续:客户端应继续发送请求主体
101Switching Protocols1xx 信息协议切换:服务器已按请求切换协议(如升级到 WebSocket)
102Processing1xx 信息处理中:服务器已接收并正在处理请求,尚无响应
200OK2xx 成功成功:请求已成功处理
201Created2xx 成功已创建:请求成功且新资源已被创建
202Accepted2xx 成功已接受:请求已接受但尚未处理完成
203Non-Authoritative Information2xx 成功非权威信息:返回的元信息来自副本而非原始服务器
204No Content2xx 成功无内容:请求成功但无返回主体
205Reset Content2xx 成功重置内容:请求成功,客户端应重置文档视图
206Partial Content2xx 成功部分内容:服务器成功处理了部分 GET 请求(用于断点续传)
300Multiple Choices3xx 重定向多种选择:请求的资源可返回多种表述
301Moved Permanently3xx 重定向永久重定向:资源已永久移动到新位置
302Found3xx 重定向临时重定向:资源临时位于不同 URI
303See Other3xx 重定向查看其它位置:应使用 GET 访问另一个 URI 获取响应
304Not Modified3xx 重定向未修改:资源未变化,可使用缓存版本
305Use Proxy3xx 重定向使用代理:必须通过指定代理访问资源(已废弃)
307Temporary Redirect3xx 重定向临时重定向:与 302 类似,但要求保持原请求方法
308Permanent Redirect3xx 重定向永久重定向:与 301 类似,但要求保持原请求方法
400Bad Request4xx 客户端错误错误请求:服务器无法理解请求的语法
401Unauthorized4xx 客户端错误未授权:请求需要身份验证
402Payment Required4xx 客户端错误需要付费:保留状态码,暂未广泛使用
403Forbidden4xx 客户端错误禁止访问:服务器理解请求但拒绝授权
404Not Found4xx 客户端错误未找到:服务器找不到请求的资源
405Method Not Allowed4xx 客户端错误方法不允许:请求方法不被该资源支持
406Not Acceptable4xx 客户端错误不可接受:无法生成符合请求 Accept 头的响应
407Proxy Authentication Required4xx 客户端错误需要代理身份验证
408Request Timeout4xx 客户端错误请求超时:客户端未在服务器等待时间内完成请求
409Conflict4xx 客户端错误冲突:请求与服务器当前状态冲突(如重复提交)
410Gone4xx 客户端错误已删除:资源曾经存在,现已永久不可用
411Length Required4xx 客户端错误需要内容长度:请求未定义 Content-Length
412Precondition Failed4xx 客户端错误前置条件失败:请求头中的条件未满足
413Payload Too Large4xx 客户端错误请求实体过大:请求主体超出服务器限制
414URI Too Long4xx 客户端错误请求 URI 过长
415Unsupported Media Type4xx 客户端错误不支持的媒体类型
416Range Not Satisfiable4xx 客户端错误范围请求无法满足
417Expectation Failed4xx 客户端错误期望失败:无法满足 Expect 头指定的要求
418I'm a teapot4xx 客户端错误我是茶壶:源自 IETF 愚人节 RFC 2324 的彩蛋状态码
422Unprocessable Entity4xx 客户端错误无法处理的实体:请求格式正确但语义错误(常见于表单校验失败)
423Locked4xx 客户端错误资源被锁定
425Too Early4xx 客户端错误请求过早:服务器不愿处理可能被重放的请求
426Upgrade Required4xx 客户端错误需要升级:客户端应切换到其它协议
428Precondition Required4xx 客户端错误需要前置条件:防止“丢失更新”问题
429Too Many Requests4xx 客户端错误请求过多:用户在给定时间内发送了太多请求(限流)
431Request Header Fields Too Large4xx 客户端错误请求头字段过大
451Unavailable For Legal Reasons4xx 客户端错误因法律原因不可用
500Internal Server Error5xx 服务器错误服务器内部错误:服务器遇到意外情况
501Not Implemented5xx 服务器错误未实现:服务器不支持该请求方法
502Bad Gateway5xx 服务器错误网关错误:作为网关的服务器收到无效响应
503Service Unavailable5xx 服务器错误服务不可用:服务器暂时无法处理请求(过载或维护)
504Gateway Timeout5xx 服务器错误网关超时:作为网关的服务器未及时收到响应
505HTTP Version Not Supported5xx 服务器错误不支持的 HTTP 版本
507Insufficient Storage5xx 服务器错误存储空间不足
508Loop Detected5xx 服务器错误检测到循环:处理请求时检测到无限循环
511Network Authentication Required5xx 服务器错误需要网络身份验证(常见于强制门户)

什么是HTTP 状态码大全?

HTTP 状态码是服务器对请求返回的三位数字响应代码,共分五类:1xx 信息性(如 100 Continue)、2xx 成功(如 200 OK)、3xx 重定向(如 301、302)、4xx 客户端错误(如 404、403)、5xx 服务器错误(如 500、502)。 这个工具收录了 IANA 注册的常见状态码,以及一些框架或 CDN 自定义的扩展状态码(如 Cloudflare 的 520-526),并附中文含义和典型触发场景,方便开发排查问题时快速查阅,而不用去翻 RFC 文档。

为什么使用HTTP 状态码大全?

排查接口报错、配置反向代理、写后端返回逻辑时经常需要确认某个状态码到底代表什么、该在什么场景返回,比如判断该用 401 还是 403、301 和 308 的区别(是否保留原请求方法)、502 和 504 的区别(网关收到无效响应 vs 网关处理超时)。 相比搜索引擎给出的零散结果,本工具把状态码集中列出并支持按类别或关键字筛选,查阅效率比翻 MDN 或维基百科更高,尤其适合调试联调时随手一查。

使用示例

区分 401 与 403

请求缺少身份凭证或凭证无效时应返回 401 Unauthorized;客户端已通过身份认证但无权限访问该资源时应返回 403 Forbidden。例如未登录访问需登录接口应返回 401,已登录但角色权限不够访问管理后台应返回 403。

301 与 302/307/308 的区别

301(永久重定向)和 308 都表示资源永久搬迁,但 301 允许客户端把原本的 POST 改成 GET 重新发起,308 强制保留原请求方法;302(临时重定向)和 307 同理,307 严格保留方法不变。做非 GET 请求的重定向时应优先用 307/308。

网关类错误定位

Nginx 返回 502 Bad Gateway 通常是后端服务未启动或返回了畸形响应;504 Gateway Timeout 则是后端处理超时,需要检查后端响应耗时或调整 proxy_read_timeout 配置。

使用提示

状态码只是约定,实际含义仍取决于服务端如何使用;调试时建议结合响应体和相关响应头(如 WWW-Authenticate、Retry-After、Location)一起判断,而不是只看数字本身。

常见问题

收录了哪些状态码?
内置了 1xx-5xx 中最常见的 50 余个 HTTP 状态码,包含官方英文名称与中文含义说明,覆盖日常开发排查的绝大多数场景。
如何快速查找某个状态码?
在过滤框输入数字码(如 404)、英文名称(如 Not Found)或中文关键词(如 未授权),会实时过滤匹配的行。
数据会上传吗?
不会。状态码表为内置静态数据,过滤与展示均在浏览器本地完成。
200 和 204 有什么区别?
200 OK 表示请求成功且响应体中通常带有数据;204 No Content 表示请求成功但响应没有实体内容,常用于 DELETE 或不需要返回数据的 PUT/PATCH 接口。
429 是什么意思?
429 Too Many Requests 表示触发了限流(Rate Limit),响应头里的 Retry-After 通常会提示多久之后可以重试。
418 是真实状态码吗?
418 I'm a teapot 最早是 IETF 在 HTCPCP 协议里的愚人节玩笑,后来被部分框架和服务当作彩蛋沿用,不属于正式的业务状态码。
3xx 状态码浏览器会自动跳转吗?
会,浏览器和大多数 HTTP 客户端收到 3xx 及 Location 响应头后会自动发起新请求,但 fetch 的 redirect 参数、curl 的 -L 选项都可以控制是否跟随跳转。

相关工具

← 返回工具箱· 数据均在浏览器本地处理,不上传服务器。