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
HTTP/1.1 201 Created
Location: /orders/123
Content-Type: application/json

{"id":123,"status":"created"}

预期结果:客户端把这次响应解释为“创建成功”,可以从 Location 获取新资源地址,并按需要读取响应体中的资源表示。

text
状态:201 Created
新资源:/orders/123

3xx 不只是让浏览器跳转

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。

http
GET /docs/intro HTTP/1.1
Host: www.example.test
If-None-Match: "v7"

预期结果:资源未变化时,服务器返回 304 且不发送新的资源表示;客户端继续使用自己已有的缓存正文。

http
HTTP/1.1 304 Not Modified
ETag: "v7"

按客户端下一步动作记状态码

遇到 2xx 时,先问“成功后有没有新资源或响应体”:普通成功读 200,创建成功关注 201,成功但无需正文关注 204。遇到 3xx 时,再问“是换地址还是复用缓存”:301、302、307、308 看 Location 与方法保留规则,304 则回到本地缓存。

这种判断比只背“2xx 成功、3xx 重定向”更可靠,因为状态码真正的价值是告诉客户端下一步如何处理响应。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 2xx 与 3xx 状态码

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通