HTTP状态码查询
查 HTTP 状态码的含义。
这个工具能做什么
这个工具做的事很直接:你输入一个 HTTP 状态码(比如 404、301、500),它就列出这个码的英文名称和对应的中文含义;输入关键词也行,比如搜「重定向」「网关」「未授权」,它会把相关的响应码一并匹配出来;什么都不输入,则默认列出 1xx 到 5xx 的常见状态码清单。它要解决的痛点是:调接口、看服务器返回、翻日志时,你拿到的往往只是一个三位数字,但没人能把几十个状态码全背下来,尤其是 307 和 308、302 和 303 这类容易混的。与其去搜索引擎翻文档,不如在本地随手查一下含义,确认自己没理解错。
HTTP 状态码是响应报文状态行里的三位数字,语义由 RFC 9110(HTTP Semantics,早期是 RFC 7231/2616)定义。它的分类规则藏在第一位数字里:1xx 是信息性响应(如 100 Continue、101 Switching Protocols),2xx 表示成功(200 OK、201 Created、204 No Content),3xx 是重定向(301、302、304),4xx 是客户端错误(400、401、403、404、429),5xx 是服务端错误(500、502、503、504)。这个工具内部维护了一张「状态码 → 名称 → 中文含义」的映射表,你输入时它按精确码值命中,或按关键词做模糊匹配,整个查询在浏览器本地完成、不上传任何数据。理解了首位数字代表的大类,即使遇到不常见的码,也能先判断个大概方向。
最典型的场景是排查接口和网关报错。举个例子,用 curl 或 Postman 调一个需要登录的接口,返回 401 还是 403 意义完全不同——401 Unauthorized 是「没带有效凭证/没认证」,通常要去检查 token;403 Forbidden 是「认证过了但没权限」,得去看角色和授权配置,查一下就不会把方向搞反。再比如 Nginx 反向代理时前端报错,502 Bad Gateway 说明上游服务返回了非法响应或直接挂了,而 504 Gateway Timeout 是上游超时没在规定时间内应答,两者对应的排查动作完全不一样,对照含义能少走很多弯路。前端拿到 304 Not Modified 时,也能立刻反应过来这是协商缓存生效、走了本地缓存而非真正的错误。
有几个容易踩的点值得留意。301 和 302 都是跳转,但 301 是永久重定向、会传递权重并被浏览器和搜索引擎缓存,302 是临时的,做 SEO 时选错会有后果;而 307/308 相比 302/301 的关键区别在于它们强制保持原请求方法(比如 POST 不会被改写成 GET)。另外要清楚,这个工具查的是 HTTP 协议标准里的状态码,业务自定义的响应体错误码(比如接口返回 200 但 body 里写着 code:10001)不在其中;一些非标准或厂商专有的码,如 Cloudflare 的 520-526、Nginx 的 499,属于扩展用法,标准清单里未必收录,遇到时需要结合具体服务端文档来看。
HTTP状态码查询是一个免费的在线工具,打开网页就能用,不用下载也不用注册。平时大家搜的“http状态码”、“状态码查询”、“http状态码大全”,说的都是这个。
常见使用场景
- 调接口返回 401 查是未认证还是没权限
- Nginx 报错时区分 502 是网关还是上游挂了
- 配置跳转前确认该用 301 还是 302
- 排查 CDN 回源报错对照 5xx 含义
- 分不清 204 和 304 时随手查一下
使用方法
- 把内容粘贴到输入框(生成类工具直接设置选项)。
- 按需要选择选项,点操作按钮。
- 结果出现在下方,点「复制结果」即可带走。