HTTP 状态码

HTTP状态码是服务器在响应中返回的三位数字，用于描述请求的处理结果。200表示请求成功，404表示页面未找到，500表示服务器发生错误。首位数字将状态码分为五大类——2xx始终表示成功，5xx始终表示服务器故障——因此只需知道类别，就能立刻判断从哪里开始排查：客户端还是服务器端。

首位数字决定类别：1xx 信息性（请求已收到并正在继续处理，如 100 Continue），2xx 成功（处理成功，如 200 OK），3xx 重定向（需要跳转至其他地址，如 301 Moved Permanently），4xx 客户端错误（请求有误，如 404 Not Found），5xx 服务器错误（服务器处理失败，如 500 Internal Server Error）。在上方工具中按任意类别筛选，可查看该类别的所有状态码及详细说明。

日常开发和调试中最常遇到的状态码有：200 OK、201 Created、204 No Content、301和302重定向、304 Not Modified、400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、429 Too Many Requests、500 Internal Server Error、502 Bad Gateway 和 503 Service Unavailable。点击上方"仅显示常用"按钮，可将完整列表过滤为这组常用状态码，并查看每个状态码的原因和修复方法。

200 OK是标准成功响应——GET请求时在响应体中返回资源，POST请求时返回操作结果。201 Created表示POST或PUT请求成功并创建了新资源；服务器通常会在Location响应头中返回新资源的地址，例如 Location: /users/42。如果你正在开发API并创建资源，应返回201并附带Location响应头，而非200，这样客户端才能知道新对象的位置。

404表示服务器在该URL下找不到任何内容——页面不存在、已迁移或链接已失效。修复方法：检查URL是否有拼写错误和大小写错误，从旧地址添加301重定向到新地址，核查服务器路由或URL重写规则，并提供一个有帮助的自定义404页面。与410 Gone不同，404并不承诺资源已永久消失，因此搜索引擎会继续爬取该URL。MDN Web Docs对规范的覆盖很全面，但本工具直接在每个状态码旁展示常见原因和修复方法，使用更便捷。

301 Moved Permanently表示资源已永久迁移至新地址，搜索引擎会将排名权重传递到新URL并更新索引——永久更改URL时应使用301。302 Found是临时重定向：原URL仍为权威地址并保留排名，适用于A/B测试或临时维护页面等短期跳转。对于非GET请求，应使用308（永久）或307（临时），因为它们会保留HTTP请求方法，而不允许浏览器将POST降级为GET。

403 Forbidden表示服务器理解了你的请求，但拒绝授权——与401不同，发送凭证也无济于事。常见原因包括：账号缺少必要的权限或作用域、服务器文件权限设置错误（例如文件权限被设为600而非644）、IP封锁或WAF规则拦截，或目录禁止了列表显示且没有默认首页。请检查账号角色、文件权限以及任何白名单配置。部分服务器会故意返回403而非404，以避免暴露资源是否存在。

四者都属于5xx服务器故障，但含义各不相同。500 Internal Server Error是通用的"出错了"——通常是应用中未处理的异常或程序漏洞。502 Bad Gateway表示代理从上游应用服务器收到了无效响应（通常是上游服务崩溃）。503 Service Unavailable表示服务器临时宕机或过载——应包含Retry-After响应头。504 Gateway Timeout表示上游服务可达，但响应时间过长。实际排查时，请从服务器日志入手来区分这些错误。

429表示触发了频率限制——在指定时间窗口内发送的请求过多。服务器应包含Retry-After响应头，告知需要等待多长时间。修复方法：遵守该响应头的等待时间、在重试之间添加指数退避、缓存响应以减少请求量，或申请更高的配额。这在公开API和登录接口防滥用场景中很常见。GitHub、Stripe、Twitter/X等平台均使用429进行API频率限制。

4xx错误是客户端的问题——请求本身有误，原样重发不会有帮助（400 Bad Request、401 Unauthorized、404 Not Found）。5xx错误是服务器的问题——你的请求可能完全正确，但服务器未能完成处理（500、502、503），待服务器恢复后同样的请求可能就能成功。4xx需要修改请求，5xx需要修复服务器。这一区分对重试逻辑至关重要：只对5xx响应进行指数退避重试，对4xx重试只会白白消耗请求配额。

关键状态码包括：200 OK（所有需要被收录的页面都应返回此状态码）、301 Moved Permanently（网站迁移时将排名传递到新URL）、302 Found（临时重定向——原URL保留权重）、404 Not Found和410 Gone（告知爬虫页面已消失；410从索引移除更快，因为它表示永久消失），以及503 Service Unavailable（计划性停机时的SEO安全状态码——告知Google稍后重试，而非直接移除索引）。

401 Unauthorized实际含义是"未经身份验证"——你尚未证明自己的身份，发送有效凭证（Token、API密钥或登录会话）即可解决；服务器应在响应中附带WWW-Authenticate响应头。403 Forbidden表示你已通过身份验证，但没有访问该资源的权限——更换凭证没有帮助，你需要不同的权限。简记：401 = 你是谁？403 = 你无权执行此操作。

四者都是重定向，但307和308保证原始HTTP方法和请求体在跳转后不变，而301和302在历史上允许客户端在重定向请求时将POST改为GET。因此，对于普通页面跳转，301（永久）和302（临时）完全够用；但对于接收POST或PUT数据的接口，永久迁移应使用308，临时迁移应使用307，以保留请求方法，避免数据丢失。

520–530范围内的状态码是Cloudflare自定义的非标准状态码，在Cloudflare与源站之间出现故障时返回——它们不属于官方HTTP规范，但在使用Cloudflare的站点上极为常见。520表示源站返回了空响应或异常响应，521表示源站拒绝连接（服务器宕机或屏蔽了Cloudflare），522表示TCP连接超时，523表示源站不可达，524表示连接成功但100秒内未响应，525和526分别是SSL握手失败和SSL证书无效，530通常是源站DNS解析错误并伴随1xxx错误码。在上方搜索框输入任意数字即可查看对应原因和修复方法。

MDN Web Docs是权威规范参考，但没有实时搜索栏、无法按类别筛选，也没有紧凑版速查表视图——每个状态码各占一个独立页面。httpstatuses.com以网格形式展示状态码，但省略了原因分析和实用修复建议。restapitutorial.com介绍REST规范惯例，但不提供交互式查询。HTTP.cat是一个有趣的表情包网站（每个状态码对应一张猫咪图片），实际调试中并不实用。本工具集可搜索参考、类别筛选、速查表模式、通俗易懂的原因分析、修复建议和Cloudflare 5xx状态码于一身，全部在单页完成，支持离线使用，无广告，无需注册。

完全免费，且充分保护隐私。完整的状态码数据以静态形式内嵌于页面中，所有搜索、筛选和查询均在你的浏览器本地运行——不上传任何数据，不记录任何日志，不向服务器发送任何信息。这也意味着页面加载即时，且在页面打开后离线也可继续使用。无需注册，无需账号，无请求限制，无付费墙。这是一个快速、私密的参考工具，在手机和电脑上同样好用。