响应代码

一、1xx:信息性(Informational)

表示请求已接收,正在处理,很少在业务中直接使用

状态码

名称

含义

100

Continue

客户端可继续发送请求体

101

Switching Protocols

协议切换(如 HTTP → WebSocket)

102

Processing

服务器处理中(WebDAV)

常见于:WebSocket、HTTP Upgrade

二、2xx:成功(Success)

请求成功处理

状态码

名称

含义

200

OK

请求成功

201

Created

资源创建成功(POST)

202

Accepted

已接收,异步处理

204

No Content

成功但无返回体

206

Partial Content

分块/断点下载

常见于:API 正常返回、文件下载、代理转发成功

三、3xx:重定向(Redirection)

需要进一步操作

状态码

名称

含义

301

Moved Permanently

永久重定向

302

Found

临时重定向

303

See Other

重定向到 GET

304

Not Modified

缓存有效

307

Temporary Redirect

临时重定向(方法不变)

308

Permanent Redirect

永久重定向(方法不变)

常见于:CDN、HTTP → HTTPS、缓存控制

四、4xx:客户端错误(Client Error)

请求有问题

状态码

名称

含义

400

Bad Request

请求格式错误

401

Unauthorized

未认证(缺 token)

403

Forbidden

已认证但无权限

404

Not Found

资源不存在

405

Method Not Allowed

方法不支持

408

Request Timeout

请求超时

409

Conflict

资源冲突

413

Payload Too Large

请求体过大

414

URI Too Long

URL 过长

429

Too Many Requests

限流

  • 401 / 403:鉴权失败

  • 404:目标服务器不存在

  • 429:IP / 用户限流

五、5xx:服务器错误(Server Error)

服务器处理失败

状态码

名称

含义

500

Internal Server Error

服务器内部错误

502

Bad Gateway

上游服务器无效

503

Service Unavailable

服务不可用

504

Gateway Timeout

上游超时

507

Insufficient Storage

存储不足

最后更新于