HTTP 状态码查询

如何使用HTTP 状态码查询

关于HTTP 状态码查询的常见问题

HTTP 状态码查询会上传我的数据吗？

不会。整份状态码表随页面一起打包在你的浏览器里，查询和粘贴解析都在本地完成，你输入的日志、响应头不会被发送到服务器，也不会写进本地存储——本地只保存你选的视图偏好和最近查过的状态码数字（纯数字，不含日志原文），随时可以点「清除记录」删掉。还有一点要说清楚：本页只解释状态码，不会去访问你输入的任何网址，它是字典而不是探针。

404 是什么意思？页面 404 怎么解决？

404 Not Found 表示服务器正常响应了，但按这个 URL 找不到对应资源。调用方先查：URL 拼写、大小写、多余或缺失的斜杠、中文和空格有没有做 URL 编码、接口前缀（例如 /api/v1）是否漏了、请求方法对不对。服务端再查：路由是否注册、路由顺序有没有被通配规则抢先匹配、静态文件是否部署到位、重写规则是否把请求吃掉、是不是被网关按路径拦掉了。注意 404 说明网络是通的、服务器是活着的，只是那个地址上没有东西。

500 错误是我的问题还是服务器的问题？

500 Internal Server Error 是服务端在处理过程中抛了没被接住的异常，责任在服务端。作为调用方你能做的有限：确认请求本身合法、换一组参数看是否稳定复现、把请求 id 或出现时间点交给服务端，然后做好退避重试与降级，别在故障期把服务打得更死。服务端应当直接去看应用日志里的堆栈，而不是靠猜——500 的信息量全在日志里，响应体通常什么都不会告诉你。常见根因是空指针、数据库连接失败、配置缺失和磁盘写满。

502、503、504 状态码有什么区别？

三个都是 5xx，但坏的地方不一样：502 Bad Gateway 是网关连上了上游、但上游返回了无效响应或者直接挂了，发布重启的那几秒最容易出现；503 Service Unavailable 是这台服务自己声明「我现在不可用」，常见于过载、维护或熔断，规范建议带上 Retry-After；504 Gateway Timeout 是网关连上了上游、但在超时时间内没等到完整响应，根因通常是慢查询或慢的第三方调用。简单记：502 上游坏了，503 本服务主动拒服务，504 上游太慢。

401 和 403 有什么区别？分别什么时候用？

401 表示没通过身份认证：没带 token、token 过期或签名不对，服务端应当带上 WWW-Authenticate 头告诉客户端该用哪种方式认证，前端通常会清掉凭证把用户送回登录页。403 表示认证过了但没有权限：你确实是这个人，但这个人不能做这件事，重新登录也没用，应该提示联系管理员。注意 401 的英文短语是 Unauthorized，字面看像「未授权」，实际含义是「未认证」，这是全网最常见的误解。

404 和 410 有什么区别？删掉的页面返回哪个？

404 表示「现在找不到」，不承诺这个资源以前有没有、以后还会不会有；410 Gone 表示「以前有，已经被永久删除了，别再来了」。如果你明确知道内容被永久下线，返回 410 更准确，搜索引擎收到这个更强的信号后通常会更快地把它从索引里去掉；不确定的情况用 404 就好。实现上还有一点差别：两者默认都属于可缓存的响应，所以别在临时故障时随手返回 404 或 410，那会被缓存下来。

301 和 302 该用哪个？对 SEO 有影响吗？

永久搬家用 301，搜索引擎会把旧地址的权重逐步转到新地址，浏览器和 CDN 默认还会缓存这个跳转；临时跳转用 302，旧地址仍被视为主地址，权重不转移。选错的代价是真实的：该用 301 时用了 302，新地址迟迟拿不到权重；该用 302 时用了 301，用户浏览器可能长期缓存着一个你早就想撤销的跳转，测试时要用无痕窗口才看得到改动。所以不确定是不是永久搬家时，先用 302 更安全。

304 状态码是什么意思？为什么刷新全是 304？

304 Not Modified 的编号落在 3xx 里，做的却不是跳转，而是条件请求的缓存校验：浏览器带着 If-None-Match 或 If-Modified-Since 去问服务端「我手上这份还能用吗」，内容没变服务端就回一个不带响应体的 304，让你继续用本地副本。所以刷新页面时静态资源大量返回 304，说明协商缓存生效了，属于正常现象，省下的是正文的传输量而不是那一次往返。想连这次往返也省掉，得靠 Cache-Control 的 max-age 命中强缓存——那时候开发者工具里显示的是 200，而不是 304。

307、308 和 301、302 有什么不一样？

关键区别是方法和请求体会不会被保留。规范本身并不允许改写方法，但实践中浏览器遇到 301、302 时普遍会把 POST 改写成 GET，请求体直接丢失，规范后来也承认了这个既成事实。307 Temporary Redirect 和 308 Permanent Redirect 是专门补上的两个码，明确要求保留原方法与请求体。所以：接口做跳转必须用 307（临时）或 308（永久），页面搬家用 301、302 即可。另外 303 See Other 正相反，它要求改成 GET，适合 POST 提交后跳到结果页。

499 是什么状态码？为什么日志里全是 499？

499 不是 RFC 定义的标准状态码，是 Nginx 自己记的：客户端在服务端还没返回之前就断开了连接，所以这条响应根本没发出去。日志里成片的 499 通常意味着后端太慢、用户等不及关掉了页面或取消了请求，也可能是客户端超时设得比服务端处理时间短，或者上层有重试机制在提前掐断连接。排查方向是后端耗时，而不是 Nginx 本身。顺带一提，Esri 的 ArcGIS Server 也用 499 表示「缺少令牌」，同码不同义，本页会并列展示。

Cloudflare 520、521、524 分别是什么错误？

这三个都是 Cloudflare 的非标准状态码，说明问题出在 Cloudflare 到你的源站之间：520 是源站返回了 Cloudflare 无法理解的响应，属于兜底错误码；521 是源站直接拒绝连接，多为服务挂了或防火墙把回源 IP 挡了；524 是连上了但源站在超时时间内没返回完，本质就是网关超时。同族还有 522 连接超时、523 源站不可达、525 与 526 的 SSL 握手与证书问题、530 加一个 1xxx 内部错误号。排查一律回到源站看日志，而不是在浏览器里打转。

接口返回 200 但业务失败该用什么状态码？

该用什么就返回什么：参数错 400、未认证 401、无权限 403、找不到 404、限流 429、服务端异常 500，业务错误码留在响应体里作为补充说明，而不是让状态码永远是 200。全部返回 200 的代价分摊在整条链路上：监控按状态码统计错误率，接口挂了也不会报警；CDN 与浏览器会按 200 的缓存规则把一个失败响应缓存下来，用户刷新也拿不到正确结果；客户端库和网关的重试策略认状态码，200 一律不重试。迁移可以渐进：新接口先用对状态码，同时保留响应体里的业务码给老客户端，等调用方都升级完再把兜底的 200 去掉。

创建成功返回什么状态码？201 和 204 怎么选？

创建成功返回 201 Created，并在 Location 头里给出新资源的地址，响应体通常带上刚创建的对象；删除成功返回 204 No Content，注意 204 的响应体必须为空，塞一段 JSON 回去反而不合规。更新成功可以用 200 并返回更新后的对象，不打算回传内容就用 204。还有一个常被忽略的场景：异步任务只是被受理、还没真正做完时应该用 202 Accepted，并在响应里告诉调用方去哪里查进度，比返回 200 假装已经完成要诚实得多。

接口参数错了应该返回 400 还是 422？

400 Bad Request 表示请求本身就不对，服务端根本没法正常解析，比如 JSON 语法错、必填字段缺失、类型完全不符；422 Unprocessable Content 表示格式解析没问题、但语义上通不过校验，比如日期在未来、金额是负数、两个字段互相冲突。两者边界确实模糊，团队内统一约定比纠结哪个更「正确」更重要，全项目只用 400 也是完全可以接受的方案。真正要避免的是同一个项目里两个码混着用，还没有文档写清边界。

429 太多请求怎么处理？Retry-After 怎么用？

429 Too Many Requests 表示你触发了限流。服务端应当在响应里带 Retry-After，值可以是秒数，也可以是一个 HTTP 日期，告诉你多久之后再来。客户端拿到 429 时应当按这个值等待，没有这个头就用指数退避（1 秒、2 秒、4 秒逐步拉长，并加一点随机抖动），不要立刻原地重试——那只会让限流更严。还要注意区分 429 和 503：针对某个调用方的限流用 429，整体不可用或维护中用 503，用错会让调用方采取错误的应对策略。

413 请求体过大怎么解决？Nginx 要改哪里？

413 Content Too Large 表示请求体超过了某一层的上限，而这个上限往往不止一层。最先撞上的通常是 Nginx：client_max_body_size 默认只有 1MB，超了直接由 Nginx 返回 413，请求根本到不了应用。把它调成 client_max_body_size 50m 之后还要逐层往里看——PHP 的 upload_max_filesize 与 post_max_size、Tomcat 的 maxPostSize、Node 里 express.json 的 limit，以及云上负载均衡和 CDN 各自的请求体上限。排查顺序是从外往里找谁先拒绝：只改了应用没改网关，返回的还是 413。

HTTP 状态码查询能直接测某个网址返回的状态码吗？

不能，这是有意的设计。从浏览器直接去请求别人的网址会被同源策略挡住，绕过它需要一个服务端代理替你发请求，那既超出了本站纯前端的范围，也属于对外探测行为。本页只做「解释状态码」这一件事，你输入的任何内容都不会被拿去访问。想看某个网址的真实状态码，用浏览器开发者工具的网络面板，或者直接看服务端的访问日志；把那一行日志粘到本页的「粘贴解析」里，就能得到含义、场景与两侧排查步骤。

418 I am a teapot 是真的 HTTP 状态码吗？

它出自 RFC 2324，一份 1998 年愚人节发布的「超文本咖啡壶控制协议」，意思是「我是茶壶，煮不了咖啡」。但它确实被不少框架和网关实现了，也常被拿来当彩蛋或反爬标记。它并不在 IANA 的正式状态码注册表里作为通用语义使用，所以不要用在生产接口上——业务含义请改用 400、403、429 这类语义明确的码，否则调用方与网关都得为它写一段特判。

粘贴解析支持哪些日志格式？状态码最多能贴多少行？

认四种常见形态：响应头首行（HTTP/1.1 404 Not Found）、Nginx 与 Apache 访问日志的请求行（"GET /a HTTP/1.1" 499 0）、curl -i 打印出来的响应头，以及整行只有一个三位数的纯状态码列表。每一行都会标出是按哪条规则识别出来的，识别不到的行也写明原因，不做黑盒猜测；日志行里的 IP、时间和字节数不会被误当成状态码。单次上限是 50000 行、2MB 文本，超出部分会明确提示被截断；逐行明细只展示前 200 行，分类占比与汇总结论仍按全部识别到的行计算。结果可以复制 TSV，也可以下载成制表符分隔的 .txt（UTF-8 编码），粘进 Excel 或表格软件即可分列。

HTTP 状态码查询工具免费吗？需要注册吗？

完全免费，不需要注册、不需要登录，也没有查询次数限制或付费档位。整份状态码表和解析逻辑随页面一起下载到你的浏览器里，之后每次查询都是本地查表，不占用服务器资源，也就没有按次收费的道理。页面不加水印、不限制复制，速查表、结果 TSV 都可以自由复制或下载，拿去写团队的接口规范、值班手册或培训材料都没有问题。唯一的规模限制在粘贴解析：单次最多 50000 行、2MB 文本，这是为了不让超大日志把你自己的浏览器卡住。

手机上能用 HTTP 状态码查询工具吗？

能，用手机浏览器打开本页即可，不用装任何 App。窄屏下并排的两张对照卡会自动竖向堆叠，速查表与逐行解析表格改成横向滑动查看，按钮和输入框保持 40 像素以上的触控高度，不至于点不中。手机上最常见的用法是值班时收到告警或截图，直接输入那个三位数看中文含义与两侧排查步骤；粘贴解析在手机上同样可用，但手机内存有限，几万行的日志还是建议回到电脑上再处理。

HTTP 状态码分类速查：1xx 2xx 3xx 4xx 5xx 分别代表什么

HTTP 响应码按首位数字分成五个大类，先看首位就能判断「这是谁的锅、该先查谁」，这是读日志时最省时间的一步。 下面这张状态码对照表给出每一类的含义与排查方向，本页的全部条目也按这五类加上一组非标准扩展来分组。

全部 HTTP 状态码速查表（http 状态码大全，按类别分组）

下面是本站收录的全部 89 个状态码（含 26 个非标准扩展）的响应状态码速查表，四列分别是状态码、英文短语、中文名和一句话含义。 需要出现场景、常见原因、两侧排查步骤和重试与缓存结论，在上方输入框里查对应的三位数字即可。状态码数据版本 2026.08，更新于 2026-08，半年复核一次。

五个最常遇到的状态码：404、403、500、502、504

这五个码占了日常排查的绝大多数。下面每一条都给出「什么场景下会看到它」以及调用方和服务端两侧分别能做什么， 不用点开交互区就能读完；想看常见原因清单、相关响应头与该不该重试，在上方输入对应数字。

301、302、303、307、308 该用哪个（重定向对照表）

重定向这一段是全网被抄错最多的地方。要点只有三句：想保住 POST 用 307 或 308；永久搬家用 301 或 308； POST 之后跳结果页用 303。下表每一格都由本站的状态码数据现算，措辞也刻意写精确—— 301 与 302 是「实践中浏览器会把 POST 改写成 GET」，而 303 是「规范明确要求改成 GET」，这两件事不是一回事。

容易搞混的状态码：401 和 403、404 和 410、400 和 422

下面每一组都给出「区别一句话」和「该用哪个」。选错状态码的代价不只是不优雅：客户端的重试策略、CDN 的缓存策略、 监控的告警规则都是按状态码分流的，用错一个码，这三层会同时做出错误决策。顺带回答两个高频问题： 301和302哪个好，要看是不是永久搬家，永久用 301、临时用 302，没有哪个天然更好；304缓存指的是协商缓存命中， 服务端只回一个空的 304 让你继续用本地副本，省下的是正文的传输量而不是那一次往返。

常见 HTTP 状态码是什么意思（403、429、499 等单码速答）

状态码什么意思，很多时候只需要一句话。下面把最常被搜到的单个码各给一句结论，想看出现场景、常见原因与两侧排查步骤， 在上方输入框里查对应数字即可。网页打不开状态码看不到时，可以打开开发者工具的网络面板；日志里的状态码 （尤其是 nginx日志状态码）在请求行引号之后；curl 查看状态码含义时，用 curl -i 把响应头首行一起打出来最省事。

英文资料里的 HTTP status codes、status code list、404 Not Found meaning、500 Internal Server Error meaning、 HTTP status code cheat sheet 指的都是同一件事：一张按状态码分类整理的对照表。本页就是它的中文版本， 而且额外给出了出现场景与两侧排查步骤。

「HTTP 200 但业务失败」为什么是反模式

很多接口无论成功失败都返回 200，把真正的结果藏在响应体里，例如 {"code":-1,"msg":"没登录"}。 这样写调用起来似乎更省事，代价却分摊在整条链路上：

• 监控与告警按状态码统计错误率，全是 200 意味着接口挂了也不会报警。
• CDN 与浏览器会按 200 的缓存规则把一个「失败响应」缓存下来，用户刷新也拿不到正确结果。
• 客户端库和网关的重试策略认状态码，200 一律不重试，真正该退避重试的场景反而被跳过。
• 登录态失效这类问题拿不到 401，前端只能靠约定的 code 值去猜，多一个团队就多一套约定。

迁移建议是渐进的：先在网关或框架层给新接口用对状态码（参数错 400、未登录 401、无权限 403、限流 429、服务端异常 500）， 同时保留响应体里的业务错误码给老客户端；等调用方都升级完，再把老接口的 200 兜底去掉。

非标准状态码是谁定义的：Cloudflare、Nginx、IIS 与 AWS

下面这些码不在 IANA 的注册表里，是各家产品自己定义的。搜「499 状态码」「520 错误」「cloudflare 520」这类问题时， 最容易踩的坑就是拿 RFC 去解释它们。本站按厂商分组收录了 26 个非标准码，含义以各厂商官方文档为准，可能随产品调整变化。

接口该返回什么状态码（restful 状态码规范与 api 状态码设计）

接口应该返回什么状态码？状态码怎么选？从「我要表达什么」出发比从码表往回套更快。下表是选码助手的完整清单： 每条给出推荐码、必带响应头、一句理由和常见的错误做法，可以直接当作团队接口规范的起点。 最常被问到的三条先说结论：创建成功返回什么状态码——201 并带 Location；删除成功返回什么状态码——204，没有响应体； 限流返回什么状态码——429 并带 Retry-After。

这些不是 HTTP 状态码（浏览器网络错误与 gRPC 编号）

在 Chrome 里看到的 ERR_CONNECTION_RESET、DNS_PROBE_FINISHED_NXDOMAIN 这类提示不是状态码， 它们发生在拿到 HTTP 响应之前——连接没建立、域名没解析、证书没通过，服务器根本还没来得及回一个状态码。 下面是最常见的对照说明，本页不把它们做成第二个字典。

为什么本页不能测某个网址的状态码

这是有意的设计，不是能力缺口。浏览器的同源策略不允许页面去读取另一个站点的响应，要绕过它就必须有一个服务端代理替你发请求； 本站一期是纯前端站点，没有这样的后端，而且「替用户去访问任意网址」本身就属于对外探测行为。 所以本页只做一件事：解释状态码。你输入的日志、网址、响应头都留在你的浏览器里。

想知道某个网址真实返回了什么状态码，有两条不依赖本站的路径：一是打开浏览器开发者工具的网络面板， 刷新页面后在请求列表里直接看 Status 列；二是去服务端看访问日志，日志行里请求行引号之后的那个三位数就是状态码。 拿到之后把那一行粘进本页的粘贴解析，就能得到中文含义、出现场景和两侧排查步骤。

HTTP 状态码数据来源与更新说明

状态码数字、英文短语与注册状态以 IANA 的 HTTP 状态码注册表为准，语义定义以 RFC 9110、RFC 9111 及各专项 RFC 为准； 非标准码以 Cloudflare、Nginx、Microsoft、AWS、cPanel 等厂商官方文档的公开说明为准，条目上都标了归属。 中文说明、出现场景与两侧排查步骤全部由本站原创撰写。非标准状态码的含义以各厂商官方文档为准，可能随产品调整变化； 排查步骤是常见方向的整理，具体以你的服务端日志为准。数据版本 2026.08，更新于 2026-08， 半年复核一次，遇到注册表增删或厂商文档调整时触发式修订。

相关教程

遇到格式选择、乱码或校验问题，可以先看这些说明再动手处理。

• 文件知识URL 编码是什么？%20、%E4%B8%AD 这类字符解释讲清 URL 编码（百分号编码）是什么：为什么网址里会出现 %20、%E4%B8%AD 这类字符、encodeURI 与 encodeURIComponent 该用哪个、和 Base64 编码有什么区别，以及什么时候需要手动做 URL 编码。
• 问题解答JSON 格式错误怎么排查？常见语法错误与修复方法JSON 解析失败的排查方法：报错行列为什么常常指偏、尾逗号与单引号等五类高频语法错误的修法、JSON 与 JavaScript 语法的差别，以及大整数精度丢失、重复键这类不报错但结果已经错了的问题。