HTTP 状态码查询
查询 HTTP 状态码含义、分类和排查建议
客户端应继续发送请求。
排查建议:通常由代理或服务器自动处理,一般无需关注。
服务器已理解客户端的 Upgrade 请求头,正在切换协议。
排查建议:常用于 WebSocket 升级,一般无需手动处理。
请求成功。
排查建议:正常响应,无需处理。
请求成功并创建了新资源。
排查建议:常见于 POST 请求后返回,应返回新资源的 Location。
请求成功但无返回内容。
排查建议:常用于 DELETE 请求或 PUT 更新成功后返回。
服务器已处理部分 GET 请求。
排查建议:常用于大文件下载、视频播放的分段请求。
资源已永久移动到新 URL。
排查建议:浏览器会缓存重定向,需要在服务器配置正确的 Location 头。SEO 应更新链接。
资源临时移动到新 URL。
排查建议:临时重定向,浏览器不会缓存。搜索引擎会保留原 URL。
资源未修改,可使用缓存版本。
排查建议:浏览器缓存机制正常工作,无需处理。
临时重定向,保持请求方法不变。
排查建议:与 302 类似,但确保 POST 请求不会被转为 GET。
永久重定向,保持请求方法不变。
排查建议:与 301 类似,但确保 POST 请求不会被转为 GET。
服务器无法理解请求,通常是参数错误。
排查建议:检查请求参数格式是否正确,是否符合 API 要求。
请求需要身份验证。
排查建议:检查是否携带了正确的认证信息(Token、Cookie 等)。
服务器理解请求但拒绝执行,通常是权限不足。
排查建议:检查用户是否有该资源的访问权限。
请求的资源不存在。
排查建议:检查 URL 是否正确,资源是否已被删除或移动。
请求方法不被允许。
排查建议:检查是否使用了正确的 HTTP 方法(GET/POST/PUT/DELETE)。
请求超时。
排查建议:服务器等待请求超时,检查网络连接或增加超时时间。
请求冲突,通常是资源状态冲突。
排查建议:检查是否存在并发修改冲突或重复创建。
资源已永久删除。
排查建议:与 404 类似,但明确表示资源已删除不会再恢复。
请求体过大。
排查建议:减小请求体大小,或调整服务器的最大请求体限制。
请求过于频繁,被限流。
排查建议:降低请求频率,检查 Retry-After 响应头等待冷却。
服务器内部错误。
排查建议:检查服务器日志,排查后端代码异常或配置错误。
网关或代理从上游服务器收到无效响应。
排查建议:检查后端服务是否正常运行,反向代理配置是否正确。
服务暂不可用,通常是过载或维护。
排查建议:检查服务器负载,等待服务恢复或排查维护状态。
网关或代理等待上游服务器响应超时。
排查建议:检查后端服务响应时间,优化慢查询或增加超时时间。
这是什么工具?
HTTP 状态码查询工具内置了常用 HTTP 状态码的详细说明,包括状态码含义、英文名称、分类、常见场景和排查建议。支持按分类筛选和关键词搜索。所有数据内置在前端,无需联网查询。适用于开发者调试接口、运维排查问题、学习 HTTP 协议等场景。
如何使用?
- 1 在搜索框输入状态码或关键词
- 2 或点击分类按钮筛选 1xx~5xx 状态码
- 3 查看状态码的详细说明和排查建议
- 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