HTTP STATUS CODES

HTTP status codes, meaning and fixes in one place.

Browse common HTTP status codes from 1xx to 5xx with standard meaning, use cases and troubleshooting tips. Runs locally in your browser.

100
Continue · 服务器已收到请求头,客户端可继续发送正文。
大文件上传或长请求的早期响应。
1xx
101
Switching Protocols · 按 Upgrade 头切换协议。
WebSocket 握手成功后即返回 101。
1xx
103
Early Hints · 在正式响应前先下发预加载提示。
用于提前开始加载字体、图片等资源。
1xx
200
OK · 请求成功,返回所请求的内容。
最常见的成功状态。
2xx
201
Created · 请求成功且在服务端创建了新资源。
POST 新增记录、创建订单时使用。
2xx
202
Accepted · 请求已接受,但处理尚未完成。
异步任务、消息队列入队时使用。
2xx
204
No Content · 成功但无返回正文。
DELETE 删除成功、埋点上报常用。
2xx
206
Partial Content · 范围请求的部分内容。
视频拖动分片、断点续传基于它。
2xx
301
Moved Permanently · 永久重定向,地址已变更。
网站改版、域名迁移,利于权重转移。
3xx
302
Found · 临时重定向,目标可能变化。
登录后回跳、活动短链常用。
3xx
304
Not Modified · 协商缓存命中,无需重传正文。
带 If-None-Match 或 If-Modified-Since 请求时返回。
3xx
307
Temporary Redirect · 临时重定向且不改变请求方法。
比 302 更严格地保持 POST 语义。
3xx
308
Permanent Redirect · 永久重定向且不改变请求方法。
301 的严格版本,保证 POST 也不变。
3xx
400
Bad Request · 请求格式错误,服务器无法处理。
JSON 语法错误、缺必填参数时出现。
4xx
401
Unauthorized · 未认证,需要提供身份凭据。
未登录或 token 失效,应附带认证挑战头。
4xx
403
Forbidden · 已识别但被拒绝访问。
权限不足、IP 被拉黑、资源禁止访问。
4xx
404
Not Found · 资源不存在或路由未匹配。
最常见的错误码,检查地址拼写与部署路径。
4xx
405
Method Not Allowed · 请求方法不被该资源允许。
如该接口只支持 POST 却发了 GET。
4xx
408
Request Timeout · 客户端发送请求超时。
网络过慢或连接闲置过久被中断。
4xx
409
Conflict · 请求与当前资源状态冲突。
重复提交、版本号乐观锁冲突。
4xx
410
Gone · 资源已被永久移除且不会恢复。
接口下线后返回,比 404 更明确。
4xx
413
Payload Too Large · 请求体过大。
上传文件或 JSON 超过服务端限制。
4xx
415
Unsupported Media Type · 不支持的媒体类型。
上传格式不在白名单,如接口只收 JSON。
4xx
422
Unprocessable Entity · 语法正确但语义无法处理。
表单校验失败、字段取值不合法。
4xx
429
Too Many Requests · 请求过于频繁,已被限流。
应配合 Retry-After 头做退避重试。
4xx
500
Internal Server Error · 服务器内部错误。
查看服务端日志,常见于未捕获异常。
5xx
501
Not Implemented · 服务器不支持该功能。
请求了尚未实现的方法或接口。
5xx
502
Bad Gateway · 网关从上游收到无效响应。
上游服务未启动或已崩溃,常见于发布瞬间。
5xx
503
Service Unavailable · 服务暂时不可用。
维护、过载或熔断中,常配 Retry-After。
5xx
504
Gateway Timeout · 网关等待上游响应超时。
上游处理过慢,检查慢查询与链路耗时。
5xx
507
Insufficient Storage · 存储空间不足。
服务器磁盘或配额已满。
5xx

31 codes

Everything runs locally in your browser

What can this tool do?

A reference of common HTTP status codes from 1xx to 5xx, each with its standard name, meaning, typical scenario and troubleshooting advice. Filter by category (informational / success / redirection / client error / server error) or search by code, English name or meaning — try 404, not found or redirect. Use the copy button beside a code to grab the value quickly when debugging APIs. Everything runs locally.

FAQ

What is the difference between 301 and 302?

301 is a permanent redirect: browsers and search engines remember it and send later requests straight to the new address. 302 is temporary and the target is not cached. Use 301 for moved URLs, 302 for temporary jumps such as post-login returns.

How do I tell 401 from 403?

401 means unauthenticated — the server is asking who you are and normally returns a challenge header. 403 means you were recognised but refused: insufficient permission. Return 401 when not logged in, 403 when logged in but not allowed.

Further reading

觉得好用?Found it useful?