HTTP 与 Web 标准 / 系统课时
看懂 2xx 与 3xx 状态码
看懂 2xx 与 3xx 状态码
看到 200、201、204 或 301、304 时,不能只判断“成功还是失败”,还要知道客户端下一步该做什么。本篇把常见 2xx 与 3xx 放回实际请求流程中,重点区分创建、无响应体、重定向和缓存验证。
学习目标
- 解释 200、201、204 在成功响应中的职责差异。
- 区分 301、302、307、308 对重定向方法处理的影响。
- 理解 304 为什么不是“返回旧内容”,以及客户端应怎样复用缓存。
2xx 表示请求已成功处理
2xx 的共同点是服务器已经成功接收、理解并处理请求,但不同状态码表达的结果不同。
| 状态码 | 含义 | 客户端通常关注什么 |
|---|---|---|
| 200 OK | 请求成功,并返回结果或资源表示 | 读取响应体 |
| 201 Created | 请求成功并创建了新资源 | 新资源位置及返回表示 |
| 204 No Content | 请求成功,但没有响应体 | 只确认操作完成 |
201 常用于创建资源。若响应带有 Location,它通常指向新建资源的 URI。204 则适合更新、删除等“操作成功但无需返回正文”的场景;客户端不应期待 204 后还有消息体。
片段示例:假设创建订单接口成功后返回 201,并通过 Location 指出新资源。
HTTP/1.1 201 Created
Location: /orders/123
Content-Type: application/json
{"id":123,"status":"created"}预期结果:客户端把这次响应解释为“创建成功”,可以从 Location 获取新资源地址,并按需要读取响应体中的资源表示。
状态:201 Created
新资源:/orders/1233xx 不只是让浏览器跳转
301、302、307、308 都能告诉客户端资源应从另一个 URI 获取,但它们对“重定向后是否保持原请求方法”有关键差异。
| 状态码 | 时间语义 | 方法处理要点 |
|---|---|---|
| 301 Moved Permanently | 永久迁移 | 历史客户端可能把 POST 改成 GET |
| 302 Found | 临时重定向 | 历史客户端可能把 POST 改成 GET |
| 307 Temporary Redirect | 临时重定向 | 必须保留原方法和请求体 |
| 308 Permanent Redirect | 永久迁移 | 必须保留原方法和请求体 |
因此,当 API 需要把一个 POST 或 PUT 请求重定向到新地址,并且必须保持方法与请求体时,307 或 308 的语义更明确。301 与 302 在浏览器历史兼容行为下可能发生方法改写,不能简单视为 307、308 的同义词。
304 是缓存验证成功
304 Not Modified 用于条件请求。客户端已经有一份缓存副本,再通过 If-None-Match 或 If-Modified-Since 询问服务器“自上次以来是否变化”。如果服务器判断资源未修改,就返回 304,客户端继续使用本地缓存,而不是等待服务器重新发送完整内容。
片段示例:客户端已有 ETag: "v7" 对应的缓存表示,随后发起条件 GET。
GET /docs/intro HTTP/1.1
Host: www.example.test
If-None-Match: "v7"预期结果:资源未变化时,服务器返回 304 且不发送新的资源表示;客户端继续使用自己已有的缓存正文。
HTTP/1.1 304 Not Modified
ETag: "v7"按客户端下一步动作记状态码
遇到 2xx 时,先问“成功后有没有新资源或响应体”:普通成功读 200,创建成功关注 201,成功但无需正文关注 204。遇到 3xx 时,再问“是换地址还是复用缓存”:301、302、307、308 看 Location 与方法保留规则,304 则回到本地缓存。
这种判断比只背“2xx 成功、3xx 重定向”更可靠,因为状态码真正的价值是告诉客户端下一步如何处理响应。