HTTP 状态码大全(快速查阅版)

IT 技术 23 阅读 更新于 2026-10-01 10:03

HTTP 状态码大全(快速查阅版)

HTTP 状态码分为 5 大类:1xx 信息响应、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误

1xx 信息响应(请求已接收,继续处理)

状态码含义场景说明
100Continue 继续客户端可以继续发送请求体;大文件上传前置校验
101Switching Protocols 切换协议WebSocket 握手,升级协议
102Processing 处理中WebDAV,服务器正在处理,还没返回结果
103Early Hints 预提示提前推送资源提示,浏览器预加载css/js

2xx 成功响应(请求成功)

状态码含义场景说明
200OK 成功GET/POST 请求正常返回数据,最常用
201Created 已创建POST 创建资源成功(新建用户、新建订单)
202Accepted 已接受请求已接收,但处理未完成(异步任务)
203Non-Authoritative Information 非权威信息代理服务器返回,内容和源服务器不一致
204No Content 无内容请求成功,但不返回响应体(删除、PUT更新)
205Reset Content 重置内容成功,要求客户端重置表单
206Partial Content 部分内容断点续传、视频分片,Range范围请求
207Multi-Status 多状态WebDAV,多个子操作混合成功/失败
208Already Reported 已汇报WebDAV,同一资源重复返回
226IM Used服务器完成增量编码

3xx 重定向(需要进一步操作)

状态码含义场景说明
300Multiple Choices 多种选择资源存在多个版本,需要客户端选择
301Moved Permanently 永久重定向资源永久迁移;SEO,旧域名→新域名;浏览器会缓存
302Found 临时重定向资源临时跳转;登录跳转;不缓存
303See Other 查看其他地址POST成功,跳转GET页面(表单提交后跳转)
304Not Modified 未修改协商缓存!资源没有更新,直接读本地缓存
305Use Proxy 使用代理废弃,要求通过代理访问
306Switch Proxy废弃,保留占位
307Temporary Redirect 临时重定向临时跳转,保留请求方法(POST跳转依然POST)
308Permanent Redirect 永久重定向永久跳转,保留请求方法

✅ 302 vs 307:302 旧浏览器会把POST改成GET;307严格保持原请求方法。
✅ 301 vs 308:同理,308永久重定向不改变请求方法。

4xx 客户端错误(请求有问题,服务器无法处理)

状态码含义场景说明
400Bad Request 请求错误参数格式错误、JSON解析失败、请求语法不对
401Unauthorized 未认证没有登录/Token失效;需要登录鉴权
402Payment Required 需要付费预留,很少用,付费接口
403Forbidden 禁止访问认证成功,但权限不足(登录了,但不能看这个资源)
404Not Found 资源不存在URL地址错误、页面/接口不存在
405Method Not Allowed 方法不允许接口只支持GET,你发了POST
406Not Acceptable 不可接受Accept头指定的格式,服务器无法返回
407Proxy Authentication Required 代理认证需要代理身份验证
408Request Timeout 请求超时客户端长时间没发完请求
409Conflict 冲突资源冲突,比如重复创建同名用户
410Gone 已永久删除资源曾经存在,现已彻底移除(区别404)
411Length Required 需要Content-Length请求缺少Content-Length头
412Precondition Failed 先决条件失败If-Match/If-Unmodified-Since校验失败
413Payload Too Large 请求体过大上传文件大小超限
414URI Too Long URI过长URL参数太长,GET参数过多
415Unsupported Media Type 不支持媒体类型Content-Type不对,比如传text但接口要json
416Range Not Satisfiable 范围请求无效断点续传请求的Range超出文件大小
417Expectation Failed 期望失败Expect请求头不被服务器支持
418I'm a teapot 我是茶壶彩蛋,RFC2324,愚人节文档,不能煮咖啡
421Misdirected Request 定向错误请求发到无法响应的服务器
422Unprocessable Entity 无法处理实体格式正确,但业务校验失败(参数合法但逻辑错误,后端校验常用)
423Locked 已锁定WebDAV,资源被锁定
424Failed Dependency 依赖失败WebDAV,前置依赖操作失败
425Too Early 请求过早防止重放攻击,请求还太早
426Upgrade Required 需要升级协议需要升级协议才能访问
428Precondition Required 需要先决条件必须带上条件头防止并发覆盖
429Too Many Requests 请求过多限流,短时间请求频率太高
431Request Header Fields Too Large 请求头过大Cookie/Header内容太多
451Unavailable For Legal Reasons 法律原因不可用因法律、合规原因无法访问

5xx 服务端错误(服务器处理时出错)

状态码含义场景说明
500Internal Server Error 服务器内部错误后端代码异常、未捕获异常,通用服务端报错
501Not Implemented 未实现服务器不支持该请求方法
502Bad Gateway 网关错误反向代理/网关,上游服务返回无效响应(网关连不上后端)
503Service Unavailable 服务不可用服务停机、过载、正在维护;临时不可用
504Gateway Timeout 网关超时网关等待上游服务响应超时(后端接口执行太久)
505HTTP Version Not Supported HTTP版本不支持服务器不支持当前HTTP版本
506Variant Also Negotiates 协商错误内容协商发生循环
507Insufficient Storage 存储空间不足WebDAV,服务器磁盘满
508Loop Detected 检测到循环WebDAV,资源引用死循环
510Not Extended 未扩展需要扩展才能处理请求
511Network Authentication Required 需要网络认证网关需要网页登录(酒店WiFi弹窗认证)

📌 高频状态码速记(开发最常用)

  • ✅ 200:成功
  • ✅ 201:创建成功
  • ✅ 204:成功无返回体
  • ✅ 301:永久重定向
  • ✅ 302:临时重定向
  • ✅ 304:协商缓存
  • ❌ 400:参数错误
  • ❌ 401:未登录/Token过期
  • ❌ 403:登录了,但没权限
  • ❌ 404:找不到资源
  • ❌ 405:请求方法不对
  • ❌ 415:Content-Type不对
  • ❌ 422:业务校验失败
  • ❌ 429:请求限流
  • ⚠️ 500:后端代码报错
  • ⚠️ 502:网关坏了/连不上后端
  • ⚠️ 503:服务挂了/维护
  • ⚠️ 504:网关超时

如果你需要,我可以单独输出一份Markdown精简版(只保留高频码,适合存笔记)或者JSON格式方便导入文档。

← 返回IT 技术 yicool 百科 · HTTP 状态码大全(快速查阅版)

评论 0