HTTP 状态码

关于 HTTP 状态码

HTTP 状态码是服务器对每个请求给出的三位数字结果，按首位分为五类：1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误。本工具内置完整的状态码字典，输入 404、301、429 等代码即可查到标准名称、含义、所属类别及常见使用场景，也支持按关键词搜索（如"重定向""未授权"）。所有处理均在浏览器本地完成，无需安装任何软件，它适合在排查接口返回、调试重定向链条或向同事解释 4xx/5xx 含义时快速查码。排查接口问题时先看状态码所属类别，能迅速判断该改客户端请求还是去查服务端日志；重定向链条尤其适合逐跳核对，配合浏览器开发者工具的网络面板，可以定位是哪一跳把请求带偏或造成了多余的往返，减少无谓的猜测。

状态码的第一位决定了响应的大类，理解这层分类比记住具体数字更实用。信息类表示请求已收到但尚未完成，成功类表示请求被正确处理，重定向类要求客户端再发起一次请求到别处，客户端错误表示请求本身有问题，服务端错误表示请求没问题但服务端处理失败。因此看到不熟悉的码，先看第一位就能判断该由谁去修。

把错误放在成功码里返回是最常见的误用，会破坏所有依赖状态码的上游逻辑。部分接口在业务失败时仍返回成功码，再在响应体里放一个错误标记，这会让监控、缓存与重试策略全部失效，因为它们只看状态码。因此正确的做法是用与语义一致的状态码表达结果，把细节放在响应体里。

临时与永久跳转的选择会影响客户端与搜索引擎的行为，混淆会带来长期问题。永久跳转会被浏览器与搜索引擎长期缓存，一旦配置错误，即使后来改回正确地址，客户端仍可能继续访问旧目标；而临时跳转不产生这种缓存。因此在本意是临时调整时应当使用临时跳转，避免留下难以撤销的缓存。

网关相关的错误码能快速区分故障位置，这在排查线上问题时很有价值。这类码通常在请求经过了网关但上游未能及时响应或响应异常时出现，因此看到它就说明问题出在网关之后而不是客户端；反之，客户端错误码说明请求根本没有到达业务逻辑。理解这一点能把排查范围立刻缩小一半。

缓存相关的码在语义上有严格区别，误用会造成用户看到过期内容。有的码要求客户端在后续请求中带上条件重新验证，有的只是表示内容未改变而无需重传，还有的用于明确指示资源已永久移除。因此在配置缓存与资源下线时应当按语义选择，而不是统一用同一个码应付。

最后，状态码与响应体的结构应当保持一致，这样客户端才能用统一逻辑处理。若一部分接口在错误时返回结构化字段，另一部分返回纯文本，客户端就需要针对每个接口单独写解析，容易遗漏。因此约定一份统一的错误结构并与状态码配套使用，是接口设计里成本很低但收益明显的规范。