HTTP 状态码速查

Continue

继续。客户端应继续请求。

场景：POST 大文件前先发 100-continue 询问

Switching Protocols

切换协议。

场景：WebSocket 握手成功

OK

请求成功。

场景：GET / POST 成功响应

Created

已创建。资源已成功创建。

场景：POST 创建用户后

Accepted

已接受。请求已接受但未处理完。

场景：异步任务排队中

No Content

无内容。请求成功但无返回体。

场景：DELETE 成功

Partial Content

部分内容。

场景：断点续传 / 视频流

Moved Permanently

永久重定向。

场景：域名变更 / HTTP→HTTPS

Found

临时重定向。

场景：登录后跳转 / 短链

Not Modified

未修改。客户端可使用缓存。

场景：ETag / Last-Modified 命中

Temporary Redirect

临时重定向（保留方法）。

场景：POST 重定向时不变方法

Permanent Redirect

永久重定向（保留方法）。

场景：类似 301 但保留 POST

Bad Request

请求语法错误。

场景：JSON 格式错 / 参数缺失

Unauthorized

未认证。

场景：Token 失效 / 未登录

Forbidden

已认证但无权限。

场景：普通用户访问管理员接口

Not Found

资源不存在。

场景：URL 错误 / 已删除

Method Not Allowed

方法不允许。

场景：GET 端点收到 POST 请求

Request Timeout

请求超时。

场景：客户端发送过慢

Conflict

资源冲突。

场景：邮箱已注册 / 乐观锁失败

Gone

资源已永久移除。

场景：比 404 更明确（用户主动删除）

Payload Too Large

请求体过大。

场景：上传文件超限

Unsupported Media Type

媒体类型不支持。

场景：Content-Type 错误

Unprocessable Entity

请求合法但语义错误。

场景：业务校验失败 / 表单字段不合规

Too Many Requests

请求过于频繁。

场景：触发限流 / 防爬虫

Internal Server Error

服务器错误。

场景：代码异常 / 未捕获错误

Not Implemented

未实现。

场景：占位接口 / 功能待开发

Bad Gateway

网关错误。

场景：Nginx 后端无响应 / 502 重启中

Service Unavailable

服务不可用。

场景：维护中 / 过载保护

Gateway Timeout

网关超时。

场景：后端接口处理超时