HTTP 与 Web 标准 / 知识点
HTTP 状态码速查手册
1xx 信息响应
HTTP/1.1 100 Continue服务器已收到请求头,客户端可以继续发送请求体。
100 Continue
服务器已收到请求头,客户端可以继续发送请求体。
典型场景
客户端先发送 Expect: 100-continue,服务端允许继续上传大请求体。
响应示例
HTTP/1.1 100 Continue
Content-Type: application/json客户端处理
继续发送 body;它只是临时响应,不是最终结果。
易混 / 边界
不要和 102 混淆:100 关注“可以继续发送请求体”。
HTTP/1.1 101 Switching Protocols服务器同意按 Upgrade 协商切换协议。
101 Switching Protocols
服务器同意按 Upgrade 协商切换协议。
典型场景
HTTP/1.1 WebSocket 等协议升级场景。
响应示例
HTTP/1.1 101 Switching Protocols
Content-Type: application/json客户端处理
切换到协商后的协议继续通信。
易混 / 边界
HTTP/2/3 不按传统 101 Upgrade 机制工作。
HTTP/1.1 102 Processing服务器已收到并正在处理请求,但尚未产生最终响应。
102 Processing
服务器已收到并正在处理请求,但尚未产生最终响应。
典型场景
WebDAV 长耗时请求的历史/扩展场景。
响应示例
HTTP/1.1 102 Processing
Content-Type: application/json客户端处理
继续等待最终响应。
易混 / 边界
较少见;不要当作通用异步任务状态。
HTTP/1.1 103 Early Hints最终响应前提前发送可能有用的 Header。
103 Early Hints
最终响应前提前发送可能有用的 Header。
典型场景
常用于提前发送 Link: rel=preload,让浏览器更早加载资源。
响应示例
HTTP/1.1 103 Early Hints
Content-Type: application/json客户端处理
处理提示信息,同时继续等待最终响应。
易混 / 边界
103 不是最终 2xx 成功响应。
HTTP/1.1 104 Upload Resumption Supported临时注册状态码,用于可恢复上传能力协商。
104 Upload Resumption Supported
临时注册状态码,用于可恢复上传能力协商。
典型场景
IETF resumable upload 草案相关实现。
响应示例
HTTP/1.1 104 Upload Resumption Supported
Content-Type: application/json客户端处理
只有明确实现对应草案时处理;普通 API 不应自行复用。
易混 / 边界
当前是临时注册,2026-11-13 到期前仍在 IANA 注册表中。
2xx 成功响应
HTTP/1.1 200 OK请求成功,响应语义取决于请求方法。
200 OK
请求成功,响应语义取决于请求方法。
典型场景
GET 返回资源、POST 返回处理结果等普通成功场景。
响应示例
HTTP/1.1 200 OK
Content-Type: application/json客户端处理
读取响应 body 和 Header。
易混 / 边界
创建资源更适合 201;成功但没有 body 更适合 204。
HTTP/1.1 201 Created请求成功并创建了一个或多个新资源。
201 Created
请求成功并创建了一个或多个新资源。
典型场景
POST 创建用户、订单、资源。
响应示例
HTTP/1.1 201 Created
Content-Type: application/json客户端处理
读取 Location 获取新资源 URI,并处理返回 representation。
易混 / 边界
不要所有 POST 成功都返回 201;只有真正创建资源时使用。
HTTP/1.1 202 Accepted请求已接受,但处理尚未完成。
202 Accepted
请求已接受,但处理尚未完成。
典型场景
异步任务、排队、后台处理。
响应示例
HTTP/1.1 202 Accepted
Content-Type: application/json客户端处理
客户端应根据任务 URL、轮询、回调等机制确认最终结果。
易混 / 边界
202 不代表最终处理成功。
HTTP/1.1 203 Non-Authoritative Information返回的元数据不是直接来自源服务器的原始权威表示。
203 Non-Authoritative Information
返回的元数据不是直接来自源服务器的原始权威表示。
典型场景
中间代理对 representation 元数据进行了转换。
响应示例
HTTP/1.1 203 Non-Authoritative Information
Content-Type: application/json客户端处理
通常像 200 一样读取内容,但应意识到中间层改写。
易混 / 边界
普通 API 很少主动使用。
HTTP/1.1 204 No Content请求成功,但响应没有内容 body。
204 No Content
请求成功,但响应没有内容 body。
典型场景
DELETE 成功、PUT 更新后无需返回内容。
响应示例
HTTP/1.1 204 No Content
Content-Type: application/json客户端处理
不要尝试解析响应 body。
易混 / 边界
与 200 的主要区别是 204 明确没有响应内容。
HTTP/1.1 205 Reset Content请求成功,并要求用户代理重置当前文档视图/输入状态。
205 Reset Content
请求成功,并要求用户代理重置当前文档视图/输入状态。
典型场景
传统表单提交后希望客户端清空表单。
响应示例
HTTP/1.1 205 Reset Content
Content-Type: application/json客户端处理
浏览器类客户端按语义重置视图。
易混 / 边界
API 场景较少使用。
HTTP/1.1 206 Partial Content服务器成功返回 Range 请求的一部分内容。
206 Partial Content
服务器成功返回 Range 请求的一部分内容。
典型场景
断点续传、视频拖动、分片下载。
响应示例
HTTP/1.1 206 Partial Content
Content-Type: application/json客户端处理
读取 Content-Range 并按范围拼接/处理。
易混 / 边界
没有 Range 语义的普通成功应返回 200。
HTTP/1.1 207 Multi-Status一个响应包含多个资源/子操作的独立状态。
207 Multi-Status
一个响应包含多个资源/子操作的独立状态。
典型场景
WebDAV 批量资源操作。
响应示例
HTTP/1.1 207 Multi-Status
Content-Type: application/json客户端处理
逐项读取多状态响应,而不能只把 207 当整体成功。
易混 / 边界
不是普通 REST 批量接口必须使用的状态。
HTTP/1.1 208 Already ReportedDAV 多状态响应中,相关成员已经报告过。
208 Already Reported
DAV 多状态响应中,相关成员已经报告过。
典型场景
WebDAV DAV:propstat 等避免重复枚举。
响应示例
HTTP/1.1 208 Already Reported
Content-Type: application/json客户端处理
按 WebDAV 语义处理。
易混 / 边界
普通 API 基本不使用。
HTTP/1.1 226 IM Used服务器对资源应用了 instance-manipulation,并返回结果。
226 IM Used
服务器对资源应用了 instance-manipulation,并返回结果。
典型场景
RFC 3229 delta encoding 扩展。
响应示例
HTTP/1.1 226 IM Used
Content-Type: application/json客户端处理
仅在实现对应增量编码扩展时处理。
易混 / 边界
极少见,不应自行赋予其他业务含义。
3xx 重定向
HTTP/1.1 300 Multiple Choices目标资源存在多个可选 representation 或位置。
300 Multiple Choices
目标资源存在多个可选 representation 或位置。
典型场景
资源存在多个可选版本。
响应示例
HTTP/1.1 300 Multiple Choices
Content-Type: application/json客户端处理
根据响应提供的信息选择目标。
易混 / 边界
现代 Web/API 中很少使用。
HTTP/1.1 301 Moved Permanently资源永久移动到新的 URI。
301 Moved Permanently
资源永久移动到新的 URI。
典型场景
网站永久改 URL、域名迁移。
响应示例
HTTP/1.1 301 Moved Permanently
Content-Type: application/json客户端处理
后续应优先使用新 URI;搜索引擎通常会更新索引。
易混 / 边界
307/308 更严格保留请求方法;历史客户端可能把 POST 301 改成 GET。
HTTP/1.1 302 Found资源暂时位于另一个 URI。
302 Found
资源暂时位于另一个 URI。
典型场景
临时跳转、登录流程。
响应示例
HTTP/1.1 302 Found
Content-Type: application/json客户端处理
按 Location 跟随;浏览器历史兼容可能改变 POST 方法。
易混 / 边界
若必须保留原请求方法,优先 307。
HTTP/1.1 303 See Other让客户端用 GET 获取另一个资源。
303 See Other
让客户端用 GET 获取另一个资源。
典型场景
POST 成功后跳到结果页,Post/Redirect/Get。
响应示例
HTTP/1.1 303 See Other
Content-Type: application/json客户端处理
对 Location 发起 GET/HEAD。
易混 / 边界
它明确用于切换到 GET,不等同于 307。
HTTP/1.1 304 Not Modified条件 GET/HEAD 验证后,缓存副本仍有效。
304 Not Modified
条件 GET/HEAD 验证后,缓存副本仍有效。
典型场景
If-None-Match / If-Modified-Since 缓存验证。
响应示例
HTTP/1.1 304 Not Modified
Content-Type: application/json客户端处理
复用本地缓存内容,不把 304 当普通空响应。
易混 / 边界
304 不是 204;它依赖已有缓存 representation。