接口联调排错
前端和后端联调登录接口,页面一直报 500。后端说接口没问题,前端说请求发对了。用本工具查 500 状态码,发现是服务器内部错误,但具体原因不明。进一步查 502 和 503 的区别,确认不是网关超时或服务不可用,定位到是后端代码抛了未捕获异常。本工具把相近状态码的差异列成对比表,省去翻文档的时间。
浏览器直接返回 404 或 500,但背后的状态码含义和常见原因往往模糊不清。这个页面列出所有 HTTP 状态码,每个都附带简短解释和典型触发场景——比如 301 是永久重定向、429 是请求过快。排查接口报错时,对照状态码能快速定位是客户端问题还是服务端异常。所有数据都在浏览器本地渲染,不发送任何请求。
前端和后端联调登录接口,页面一直报 500。后端说接口没问题,前端说请求发对了。用本工具查 500 状态码,发现是服务器内部错误,但具体原因不明。进一步查 502 和 503 的区别,确认不是网关超时或服务不可用,定位到是后端代码抛了未捕获异常。本工具把相近状态码的差异列成对比表,省去翻文档的时间。
老域名要迁移到新域名,运维在 Nginx 配了 301 永久重定向。配完后用 curl 测试,返回 200 而不是 301。查本工具发现 301 要求响应头带 Location 字段,且浏览器会缓存。按工具里的实战示例检查配置,发现少写了 `return 301` 后的地址,修正后再次验证返回正确。本工具把状态码的请求-响应流程画成示意图,一眼看出缺了哪个字段。
用户反馈图片加载慢,运维查 CDN 节点日志,发现大量 504 状态码。用本工具查 504 含义是网关超时,说明 CDN 节点向源站请求时超时了。结合工具里的常见原因列表,检查源站防火墙发现误封了 CDN 节点 IP。解封后 504 消失。本工具把每个状态码的常见根因整理成清单,不用挨个搜论坛。
开放平台要给第三方开发者限流,防止单个应用拖垮服务。设计时纠结用 429 还是 503。查本工具发现 429(Too Many Requests)专用于限流,且 RFC 6585 建议返回 Retry-After 头部告诉客户端多久后重试。而 503 表示服务暂时不可用,语义不准确。按工具里的 RFC 引用确认了方案,上线后客户端按头部字段自动退避,没有再报错。
支付系统回调地址返回 200 但业务方说没收到通知。用本工具查 200 和 204 的区别:200 会带响应体,204 无内容但都表示成功。检查发现回调处理函数返回了 200 但没写响应体,支付系统认为响应格式不完整。工具里的实战示例展示了标准回调应返回的 JSON 结构,按示例改造后回调成功率从 60% 升到 100%。
| 输入 | 输出 | 说明 |
|---|---|---|
| 200 | 200 OK — 请求成功。服务器成功处理了请求。实战示例:浏览器访问正常网页时返回此状态码。 | 常规:最常用的成功状态码,验证工具是否能正确识别标准成功响应。 |
| 404 | 404 Not Found — 服务器找不到请求的资源。实战示例:用户在浏览器输入错误URL或访问已删除页面时返回此状态码。 | 常规:最常见的客户端错误码,覆盖用户日常遇到最多的场景。 |
| 301 | 301 Moved Permanently — 请求的资源已被永久移动到新URL。实战示例:网站更换域名时,旧域名返回301并跳转到新域名。 | 常规:重定向类状态码的代表,与302区分是常见考点。 |
| 100 | 100 Continue — 客户端应继续发送请求的剩余部分。实战示例:客户端发送带大文件的上传请求前,先发送Expect: 100-continue头,服务器确认可接收后再发送完整请求体。 | 边界:信息类状态码(1xx)很少被用户直接看到,但协议层面重要,验证工具是否覆盖完整状态码范围。 |
| 418 | 418 I'm a Teapot — 超文本咖啡壶控制协议(HTCPCP)中定义的愚人节玩笑状态码,表示服务器拒绝用茶壶煮咖啡。实战示例:Google的I'm Feeling Lucky按钮曾返回此状态码作为彩蛋。 | 边界:非标准但广泛认知的彩蛋状态码,验证工具是否包含非正式但常见的状态码。 |
| 503 | 503 Service Unavailable — 服务器暂时无法处理请求(可能因过载或维护)。实战示例:电商平台双十一期间流量过大时,负载均衡器返回503并提示稍后重试。 | 易错:与500(服务器内部错误)易混淆,503强调临时性,500强调程序错误。 |
| 999 | 999 — 非标准状态码。常见于某些网站(如LinkedIn)用于反爬虫限制。实战示例:LinkedIn对频繁访问的爬虫返回999,表示请求被拒绝但未使用标准429或403。 | 易错:超出标准HTTP状态码范围(100-511),验证工具是否对非标准码给出合理说明而非报错。 |
1.把 301 和 302 当成一回事
网站迁移用 302 临时重定向,搜索引擎一直不更新索引永久迁移用 301,临时活动/页面下线用 302301 是永久重定向,搜索引擎会更新索引到新 URL;302 是临时重定向,搜索引擎保留原 URL。混用会导致 SEO 问题。
2.404 和 410 不分,影响 SEO 信号
已彻底删除的商品页返回 404,搜索引擎仍定期爬取已彻底删除且不再恢复的页面返回 410 Gone410 明确告知资源已永久删除,搜索引擎会更快从索引中移除;404 仅表示暂时找不到,搜索引擎可能继续尝试。
3.把 500 当万能错误码用
后端捕获所有异常后统一返回 500 Internal Server Error参数校验失败返回 400,权限不足返回 403,资源不存在返回 404,服务器内部异常才返回 500500 只表示服务器内部无法处理的意外情况。滥用 500 会让运维无法区分是业务逻辑错还是基础设施故障。
4.认为 200 OK 一定表示请求成功
API 返回 200 但 body 里带 error: true,前端只看状态码API 业务错误应返回 4xx 状态码(如 422 Unprocessable Entity),body 只放错误详情HTTP 状态码是协议层面的信号,业务逻辑错误应该用 4xx 系列表示,否则监控系统无法区分正常请求和业务异常。
5.把 429 当成临时故障,不处理限流逻辑
收到 429 Too Many Requests 后立即重试相同请求读取 Retry-After 响应头,等待指定秒数后再重试429 是服务器明确告知客户端请求过载,不等待直接重试会加剧服务器压力,甚至触发 IP 封禁。
6.混淆 401 和 403 的语义
未登录用户访问需要登录的页面,返回 403 Forbidden未认证返回 401 Unauthorized,已认证但无权限才返回 403 Forbidden401 表示需要身份验证(未登录/Token 过期),403 表示服务器理解请求但拒绝执行(已登录但无权限)。
7.认为 304 是错误状态码
看到浏览器返回 304 Not Modified 就以为是缓存异常304 是正常状态码,表示资源未修改,浏览器直接使用本地缓存304 是 HTTP 缓存机制的一部分,配合 If-Modified-Since 或 ETag 使用,能减少带宽消耗和加载时间。
8.把 503 和 504 混用
上游服务超时返回 503 Service Unavailable上游服务无响应/超时返回 504 Gateway Timeout,服务器自身过载才返回 503503 是服务器自身无法处理请求(如过载、维护);504 是网关/代理在等待上游响应时超时。两者根因不同,排查方向也不同。
状态码类别 = floor(状态码 / 100) × 100
状态码三位整数,如 200、404状态码类别百位整数,如 200、400状态码 503:floor(503 / 100) × 100 = 5 × 100 = 500,属于 5xx 服务器错误类别。
可以。本工具不仅显示状态码的标准含义,还提供「实战示例」—— 比如 429 Too Many Requests 会说明「API 限流时返回,例如 1 分钟内请求超过 100 次」,301 Moved Permanently 会举「网站改域名后旧地址返回 301 跳转新址」。直接看示例区就能对应到真实场景。
418 I'm a Teapot 是 RFC 2324 定义的愚人节玩笑码,实际生产环境极少主动返回,但部分老旧代理或框架在调试日志里会出现。本工具把它归在「非标准 / 扩展码」分组,并标注「超文本咖啡壶控制协议」出处,方便排查日志时快速确认不是真实错误。如果只关心常用码,可以只看主分组。
可以。本工具在 302 Found 的实战示例里会标注「HTTP/1.0 标准,浏览器通常用 GET 重定向,即使原请求是 POST」,而 307 Temporary Redirect 的示例会强调「必须保持原请求方法(POST 仍是 POST)」。两个码的说明区域紧挨着,对比看就能分清使用场景。
本工具对 500 的实战示例会列出常见子原因:未捕获异常、数据库连接超时、配置文件语法错误。同时会提示「查看应用服务器日志(如 Nginx error.log、Tomcat catalina.out)定位具体报错行」,而不是只停留在状态码本身。如果你需要更精确的 5xx 细分(如 502/503/504),工具也分别给出了网关超时、服务过载、上游无响应等典型触发条件。
本工具是纯前端实现,所有状态码编号、标准含义、实战示例都打包在页面内,不依赖网络请求。打开一次后,即使断网也能正常查询。数据来源基于 IETF RFC 规范(RFC 7231、RFC 6585 等),不含实时爬取内容,所以查询结果不会因网络变化而不同。
可以。本工具在 401 的实战示例写「未提供有效认证凭据,如缺少 Authorization 头」,403 则写「已认证但无权限,如普通用户访问管理员接口」。两个码在列表里相邻排列,并且各有一条加粗的关键词差异行:「401 → 缺身份」「403 → 缺权限」。扫一眼就能区分。
103 Early Hints 是 HTTP/2 新增的预加载提示码,用于提前推送关键资源(如 CSS/JS),浏览器不直接显示但 CDN 和服务器会用;208 Already Reported 是 WebDAV 扩展码,只在文件同步协议中出现。本工具把它们放在「扩展 / 实验性」分组并标注使用场景,方便后端或运维人员查日志时知道来源,对前端开发者可以忽略。
可以。每个状态码的结果区右侧有一个「复制」按钮,点击后会把「状态码 + 标准含义 + 实战示例」拼接成一段纯文本(例如:404 Not Found:服务器找不到请求的资源。常见原因:URL 拼写错误、资源已删除、路由未匹配。),方便粘贴到钉钉/微信/邮件里讨论,不需要手动截图或打字。
隐私保证所有计算与处理均在你的浏览器本地完成,输入数据不会上传服务器,也不会保存或共享。