UPTools UPTools

HTTP 状态码查询

查询 HTTP 状态码含义、分类和排查建议

本工具在浏览器本地运行,不会上传你的数据,保护你的隐私安全。
100Continue

客户端应继续发送请求。

排查建议:通常由代理或服务器自动处理,一般无需关注。

101Switching Protocols

服务器已理解客户端的 Upgrade 请求头,正在切换协议。

排查建议:常用于 WebSocket 升级,一般无需手动处理。

200OK

请求成功。

排查建议:正常响应,无需处理。

201Created

请求成功并创建了新资源。

排查建议:常见于 POST 请求后返回,应返回新资源的 Location。

204No Content

请求成功但无返回内容。

排查建议:常用于 DELETE 请求或 PUT 更新成功后返回。

206Partial Content

服务器已处理部分 GET 请求。

排查建议:常用于大文件下载、视频播放的分段请求。

301Moved Permanently

资源已永久移动到新 URL。

排查建议:浏览器会缓存重定向,需要在服务器配置正确的 Location 头。SEO 应更新链接。

302Found

资源临时移动到新 URL。

排查建议:临时重定向,浏览器不会缓存。搜索引擎会保留原 URL。

304Not Modified

资源未修改,可使用缓存版本。

排查建议:浏览器缓存机制正常工作,无需处理。

307Temporary Redirect

临时重定向,保持请求方法不变。

排查建议:与 302 类似,但确保 POST 请求不会被转为 GET。

308Permanent Redirect

永久重定向,保持请求方法不变。

排查建议:与 301 类似,但确保 POST 请求不会被转为 GET。

400Bad Request

服务器无法理解请求,通常是参数错误。

排查建议:检查请求参数格式是否正确,是否符合 API 要求。

401Unauthorized

请求需要身份验证。

排查建议:检查是否携带了正确的认证信息(Token、Cookie 等)。

403Forbidden

服务器理解请求但拒绝执行,通常是权限不足。

排查建议:检查用户是否有该资源的访问权限。

404Not Found

请求的资源不存在。

排查建议:检查 URL 是否正确,资源是否已被删除或移动。

405Method Not Allowed

请求方法不被允许。

排查建议:检查是否使用了正确的 HTTP 方法(GET/POST/PUT/DELETE)。

408Request Timeout

请求超时。

排查建议:服务器等待请求超时,检查网络连接或增加超时时间。

409Conflict

请求冲突,通常是资源状态冲突。

排查建议:检查是否存在并发修改冲突或重复创建。

410Gone

资源已永久删除。

排查建议:与 404 类似,但明确表示资源已删除不会再恢复。

413Payload Too Large

请求体过大。

排查建议:减小请求体大小,或调整服务器的最大请求体限制。

429Too Many Requests

请求过于频繁,被限流。

排查建议:降低请求频率,检查 Retry-After 响应头等待冷却。

500Internal Server Error

服务器内部错误。

排查建议:检查服务器日志,排查后端代码异常或配置错误。

502Bad Gateway

网关或代理从上游服务器收到无效响应。

排查建议:检查后端服务是否正常运行,反向代理配置是否正确。

503Service Unavailable

服务暂不可用,通常是过载或维护。

排查建议:检查服务器负载,等待服务恢复或排查维护状态。

504Gateway Timeout

网关或代理等待上游服务器响应超时。

排查建议:检查后端服务响应时间,优化慢查询或增加超时时间。

这是什么工具?

HTTP 状态码查询工具内置了常用 HTTP 状态码的详细说明,包括状态码含义、英文名称、分类、常见场景和排查建议。支持按分类筛选和关键词搜索。所有数据内置在前端,无需联网查询。适用于开发者调试接口、运维排查问题、学习 HTTP 协议等场景。

如何使用?

  1. 1 在搜索框输入状态码或关键词
  2. 2 或点击分类按钮筛选 1xx~5xx 状态码
  3. 3 查看状态码的详细说明和排查建议
  4. 4 点击「复制」复制状态码说明

常见问题

404 是什么意思?

表示请求的资源不存在,检查 URL 是否正确。

301 和 302 有什么区别?

301 是永久重定向,浏览器会缓存;302 是临时重定向,不会缓存。

需要联网查询吗?

不需要,状态码数据内置在前端,离线也能使用。

适用场景与示例

  • 调试接口返回码,快速理解 2xx/4xx/5xx 的含义
  • 排查 401/403 鉴权失败、500 服务端异常
  • 区分重定向家族 301/302/307/308
  • 学习 HTTP 协议、准备技术面试

输入

状态码 404

输出

Not Found / 客户端错误(4xx)/ 资源不存在,检查 URL

💡 粗略口诀:4xx 是客户端的锅,5xx 是服务端的锅。

原理与常见错误

HTTP 状态码是三位数字,按首位分成 5 类:1xx 信息性(请求已接收、继续处理);2xx 成功(200 OK、201 Created、204 No Content);3xx 重定向(301 永久、302 临时、304 未修改走缓存);4xx 客户端错误(400 参数错、401 未认证、403 无权限、404 不存在、429 限流);5xx 服务端错误(500 内部错误、502 网关上游无效、503 暂不可用、504 网关超时)。最易混淆的两组:①重定向——301/308 是永久(浏览器和搜索引擎会缓存),302/307 是临时;307/308 严格保留原请求方法(POST 还是 POST),而历史上的 302 可能被改成 GET;②客户端错误——401 是「没登录/没认证」(Unauthenticated),403 是「登录了但没权限」(Forbidden),两者常被混用但语义和排查方向不同。

⚠️ 混淆 401 与 403

401 是未认证(没带或带错了凭证),403 是已认证但无权限,排查方向完全不同。

⚠️ 以为 302 会被缓存

只有 301/308 这种「永久」重定向才会被浏览器/搜索引擎缓存,302/307 不会。

⚠️ 分不清 500/502/504

500 是服务端自身崩溃;502 是网关收不到上游有效响应;504 是网关等上游超时。

⚠️ 用 200 返回业务错误

RESTful 语义下业务失败也应返回对应的 4xx/5xx,而不是 200 里塞 error 字段。

参考与更新

最后更新:2026-06-29

相关工具