HTTP 请求调试 by 无情

请求构造

0 个生效 Header

请求头每行一条：名称: 值

Content-Type

请求体 GET / HEAD 不发送请求体

响应

填写上方请求并点击「发送」，响应会显示在这里。

等待发送

状态码速查

响应后自动定位

62 条

1xx 信息响应（4）

100
Continue
继续

服务器已收到请求头，客户端应继续发送请求体

场景：一般不会在浏览器里看到；大请求体分段发送前的握手
101
Switching Protocols
切换协议

服务器同意按请求切换协议（如升级到 WebSocket）

场景：WebSocket 握手的正常响应
102
Processing
处理中

服务器还在处理，防止客户端超时（WebDAV）

场景：处理耗时较长时由中间件临时返回
103
Early Hints
早期提示

在最终响应前提前推送资源链接，让浏览器预加载

场景：配合 Link 头预加载 CSS / 字体等关键资源

2xx 成功（10）

200
OK
成功

请求成功，响应体携带所请求的内容

场景：最常见的成功响应，GET / POST 都可能是 200
201
Created
已创建

请求成功且已在服务器上创建新资源

场景：POST 建资源成功；响应应带 Location 头指向新资源
202
Accepted
已接受

请求已受理，但处理尚未完成

场景：异步任务入队成功；用状态接口轮询进度
203
Non-Authoritative Information
非权威信息

响应用的是代理转述而非源服务器内容

场景：中间代理改写响应时返回
204
No Content
无内容

请求成功，但没有响应体可返回

场景：删除成功、更新成功且不返回数据时常用
205
Reset Content
重置内容

请求成功，指示客户端清空当前文档（如表单）

场景：提交表单成功后让页面回到初始态
206
Partial Content
部分内容

只返回了请求的范围（Range）内的内容

场景：视频拖拽、断点续传的响应
207
Multi-Status
多状态

一次返回多个子操作的不同状态（WebDAV）

场景：批量操作接口，body 里逐条给出状态
208
Already Reported
已报告

同一资源在批量操作里被重复列出（WebDAV）

场景：配合 207 使用，避免重复枚举
226
IM Used
已使用 IM

服务器完成了 GET 并使用了实例操控（delta 编码）

场景：增量同步场景，很罕见

3xx 重定向（8）

300
Multiple Choices
多种选择

同一资源有多个表示，需客户端选择

场景：内容协商返回多个候选；现在很少用
301
Moved Permanently
永久移动

资源已永久迁移到 Location 指向的新地址

场景：域名或路径变更；浏览器会缓存并直接走新地址
302
Found
临时移动

资源暂时在新地址，后续仍应访问原地址

场景：临时跳转（登录后回跳、短链）
303
See Other
查看其它

GET 到 Location 的地址查看结果

场景：POST 提交后 303 跳转到结果页，防止刷新重复提交
304
Not Modified
未修改

条件请求命中，资源未变化，用本地缓存即可

场景：带 If-None-Match / If-Modified-Since 的请求命中缓存
305
Use Proxy
使用代理

必须通过 Location 指定的代理访问

场景：已被弃用，出于安全原因浏览器不再实现
307
Temporary Redirect
临时重定向

与 302 语义相同，但必须保持原请求方法与请求体

场景：临时迁移但不想丢失 POST 数据时使用
308
Permanent Redirect
永久重定向

与 301 语义相同，但必须保持原请求方法与请求体

场景：永久迁移且要保留 POST 语义时使用

4xx 客户端错误（29）

400
Bad Request
请求错误

请求语法或参数有误，服务器无法理解

场景：JSON 解析失败、缺少必填字段、参数格式错误
401
Unauthorized
未认证

缺少或无效的认证信息，请先登录或带上凭据

场景：Token 缺失 / 过期 / 无效；检查 Authorization 头
402
Payment Required
需要付款

预留用于付费访问，目前没有官方标准用法

场景：多见于第三方封禁付费墙场景
403
Forbidden
禁止访问

已认证但没有权限访问该资源

场景：权限不足、IP 被拒、防盗链；区别于 401（未认证）
404
Not Found
未找到

资源不存在，或服务端刻意不暴露其存在

场景：路径写错、资源已删除；也常被用来掩盖权限问题
405
Method Not Allowed
方法不允许

该资源不支持当前请求方法

场景：接口只允许 GET 却发了 POST；检查方法是否拼错
406
Not Acceptable
无法接受

无法按 Accept 头声明的格式返回内容

场景：客户端要求 XML 而服务端只产出 JSON
407
Proxy Authentication Required
需要代理认证

需先通过代理的认证

场景：企业代理环境的鉴权提示
408
Request Timeout
请求超时

服务器等待请求超时，客户端未及时发送完

场景：上传大文件时连接中断
409
Conflict
冲突

请求与资源当前状态冲突，无法执行

场景：版本号不一致、用户名已被占用、并发编辑冲突
410
Gone
已删除

资源曾存在但已被永久移除，且不会再恢复

场景：活动已下线、旧版本接口已废弃
411
Length Required
需要内容长度

请求需要 Content-Length 头

场景：少见；分块传输时一般不会触发
412
Precondition Failed
前置条件失败

请求头的前置条件（If-*）不满足

场景：If-Match 与当前 ETag 不符，乐观锁校验失败
413
Payload Too Large
载荷过大

请求体超过服务器允许的大小

场景：上传文件超过限制；检查请求体大小
414
URI Too Long
URI 过长

URL 超过服务器允许的长度

场景：GET 塞了大量查询参数；改用 POST
415
Unsupported Media Type
不支持的媒体类型

请求体的 Content-Type 不被服务器支持

场景：发了 text/plain 但接口只收 application/json
416
Range Not Satisfiable
范围不满足

请求的 Range 超出资源实际大小

场景：视频切片请求超出文件长度
417
Expectation Failed
预期失败

Expect 头声明的条件无法满足

场景：Expect: 100-continue 被服务器拒绝
418
I'm a Teapot
我是一个茶壶

愚人节玩笑，服务器拒绝用咖啡壶身份泡茶

场景：茶壶协议彩蛋；API 有时用它表示「拒绝执行」
421
Misdirected Request
错误导向的请求

请求被发给无法响应它的服务器

场景：SNI 与证书域名不匹配时出现
422
Unprocessable Entity
无法处理的实体

语法正确但语义有误（校验失败）

场景：字段值不符合业务规则，如邮箱格式不对
423
Locked
已锁定

资源被锁定，当前操作不被允许（WebDAV）

场景：协同编辑时资源被他人占用
424
Failed Dependency
依赖失败

当前请求依赖的另一个请求失败（WebDAV）

场景：批量操作中前置步骤失败导致后续无法执行
425
Too Early
太早

服务器出于重放攻击防护，拒绝处理过早的请求

场景：TLS 1.3 0-RTT 场景
426
Upgrade Required
需要升级

服务器要求改用升级后的协议

场景：要求从 HTTP 升级到 TLS
428
Precondition Required
需要前置条件

服务器要求请求带 If-Match 等前置条件

场景：强制乐观锁更新时返回
429
Too Many Requests
请求过多

请求频率超过限流阈值

场景：被限流；检查 Retry-After 头并退避重试
431
Request Header Fields Too Large
请求头过大

请求头整体超过服务器限制

场景：Cookie 太大或 Authorization 异常膨胀
451
Unavailable For Legal Reasons
法律原因不可用

因法律 / 政策要求拒绝提供该资源

场景：内容被依法下架的地区性屏蔽

5xx 服务器错误（11）

500
Internal Server Error
服务器内部错误

服务器内部异常，无法完成请求

场景：后端未捕获的异常；找服务端看日志
501
Not Implemented
未实现

服务器不支持该请求方法

场景：网关 / 老旧服务不支持 PUT 等
502
Bad Gateway
网关错误

上游服务器返回了无效响应

场景：反向代理后端的服务挂了或响应异常
503
Service Unavailable
服务不可用

服务暂时不可用，通常因为过载或维护

场景：重启中、过载保护；看 Retry-After 头
504
Gateway Timeout
网关超时

上游服务器在限期内未响应

场景：后端接口慢导致代理超时；排查上游耗时
505
HTTP Version Not Supported
不支持的 HTTP 版本

服务器不支持请求使用的 HTTP 版本

场景：极罕见，客户端用了过新或过旧的协议版本
506
Variant Also Negotiates
变体协商

内容协商配置成环，服务器无法决定返回哪个表示

场景：服务器配置错误导致协商死循环
507
Insufficient Storage
存储不足

服务器存储空间不足，无法完成请求（WebDAV）

场景：磁盘写满时的 WebDAV 操作
508
Loop Detected
检测到循环

请求在服务器间无限循环转发（WebDAV）

场景：代理或重写规则配置成环
510
Not Extended
未扩展

请求需要额外的扩展才能被处理

场景：HTTP 扩展协商机制，罕见
511
Network Authentication Required
需要网络认证

需先通过网络接入认证（如登录 WiFi 门户）

场景：连接公共 WiFi 时浏览器会拦截并跳转认证页

HTTP 请求调试工具

HTTP 请求调试工作区

请求调试与代码生成

请求构造

响应

Continue

Switching Protocols

Processing

Early Hints

OK

Created

Accepted

Non-Authoritative Information

No Content

Reset Content

Partial Content

Multi-Status

Already Reported

IM Used

Multiple Choices

Moved Permanently

Found

See Other

Not Modified

Use Proxy

Temporary Redirect

Permanent Redirect

Bad Request

Unauthorized

Payment Required

Forbidden

Not Found

Method Not Allowed

Not Acceptable

Proxy Authentication Required

Request Timeout

Conflict

Gone

Length Required

Precondition Failed

Payload Too Large

URI Too Long

Unsupported Media Type

Range Not Satisfiable

Expectation Failed

I'm a Teapot

Misdirected Request

Unprocessable Entity

Locked

Failed Dependency

Too Early

Upgrade Required

Precondition Required

Too Many Requests

Request Header Fields Too Large

Unavailable For Legal Reasons

Internal Server Error

Not Implemented

Bad Gateway

Service Unavailable

Gateway Timeout

HTTP Version Not Supported

Variant Also Negotiates

Insufficient Storage

Loop Detected

Not Extended

Network Authentication Required