全部 HTTP 状态码的含义与使用场景，支持搜索。
所有处理都在本地完成，不会上传任何内容。
2xx · 成功
The request succeeded. The body holds the result: the resource for GET, the outcome of the action for POST.
The default success response. Prefer 201 when something was created and 204 when there is nothing to return.
HTTP/1.1 200 OKHTTP/2 和 HTTP/3 只发送数字，放在 :status 伪头部中；原因短语（reason phrase）只存在于 HTTP/1.x。
这是一份可搜索的参考，涵盖 IANA 注册表中所有标准 HTTP 响应状态码，从 <code>100 Continue</code> 到 <code>511 Network Authentication Required</code>。每个状态码都附有通俗易懂的解释、服务器或 API 应在何时返回它的建议、与之配套的响应头，以及定义它的 RFC 链接。常见的非官方状态码——nginx 的 <code>499</code>、Laravel 的 <code>419</code>、Cloudflare 的 <code>520</code>–<code>526</code>——也已收录并明确标注。可按数字、名称或关键词（如 "redirect" 或 "rate limit"）搜索。
404）、开头数字（40）、类别（4xx）、名称（teapot）或关键词（rate limit、cache、Retry-After）。#404 结尾，打开时直接定位到该状态码。客户端遇到无法识别的状态码时，会按其所属类别的 x00 码处理，因此未知的 499 会被当作 400，未知的 299 会被当作 200。正因如此，新增状态码不会破坏旧软件。
大多数 API 只需要十几个状态码。成功时：带响应体用 200；创建了资源用 201 并附上 Location 头；任务稍后执行用 202；没有内容可返回用 204。客户端错误：请求格式错误用 400；格式正确但未通过校验用 422；缺少凭据或凭据无效用 401；凭据有效但权限不足用 403；资源不存在用 404；发生冲突（如邮箱重复）用 409；限流用 429。服务器错误：程序 bug 用 500，中间基础设施故障用 502、503 和 504。
无论返回哪个状态码，都应附上解释它的响应体。RFC 9457 "Problem Details"（application/problem+json）为这种响应体定义了标准结构，包含 type、title、status 和 detail 字段。切勿返回 200 却在响应体中放错误信息：缓存、监控和重试逻辑读取的都是状态码，而不是你的 JSON。要格式化这类响应体，可使用 JSON 格式化工具。
搜索引擎会仔细读取状态码。页面永久迁移时使用 301 或 308，让排名随之转移；302 则告诉搜索引擎继续索引旧 URL。对已不存在的页面返回真正的 404 或 410——返回 200 的“未找到”页面属于“软 404”（soft 404），会浪费抓取预算。维护期间返回 503 并附上 Retry-After，避免页面被移出索引。可以用 robots.txt 生成器控制爬虫可访问的内容。
状态码为 200、203、204、206、300、301、308、404、405、410、414、451 和 501 的响应，即使没有明确的新鲜度响应头，也可能被浏览器和 CDN 缓存，因此一个意外的 404 或 301 可能会长期存在；请为这些响应有意识地设置 Cache-Control。
有些状态码不在 IANA 注册表中，但在实践中很常见。客户端在收到响应前断开连接时，nginx 会记录 499；nginx 不作应答直接关闭连接时记录 444。Cloudflare 无法从源服务器获得正常响应时返回 520–526：521 表示源服务器拒绝连接，522 表示连接超时，524 表示源服务器超过 100 秒才响应，525/526 表示与源服务器的 TLS 连接失败。Laravel 在 CSRF 令牌过期时返回 419。这些状态码在列表中标注为“非官方”，并可以隐藏。