Appearance
常用 HTTP 状态码
HTTP 状态码用于表示客户端与服务器之间请求的处理结果。以下是常用状态码的分类及其含义:
✅ 成功类(Success)
状态码 | 含义 |
---|---|
200 OK | 请求成功,服务器已返回请求的数据。 |
201 Created | 请求成功并创建了新的资源(常用于 POST 请求)。 |
202 Accepted | 请求已接受,但尚未处理完成。 |
204 No Content | 请求成功,但无返回内容。 |
206 Partial Content | 返回部分内容(用于范围请求)。 |
🔁 重定向类(Redirection)
状态码 | 含义 |
---|---|
301 Moved Permanently | 资源已永久迁移至新的 URL。 |
302 Found | 资源临时移动至新的 URL。 |
304 Not Modified | 资源未修改,使用缓存。 |
307 Temporary Redirect | 临时重定向,且保持原请求方法。 |
308 Permanent Redirect | 永久重定向,且保持原请求方法。 |
🚫 客户端错误类(Client Error)
状态码 | 含义 |
---|---|
400 Bad Request | 请求语法错误,服务器无法理解。 |
401 Unauthorized | 请求需要身份验证或验证失败。 |
403 Forbidden | 服务器理解请求但拒绝执行,无权限。 |
404 Not Found | 请求的资源不存在。 |
405 Method Not Allowed | 请求方法不被允许(如禁用 PUT、DELETE)。 |
408 Request Timeout | 请求超时,客户端未在服务器等待时间内完成请求。 |
429 Too Many Requests | 客户端发送的请求过多,触发了速率限制。 |
🛠️ 服务器错误类(Server Error)
状态码 | 含义 |
---|---|
500 Internal Server Error | 通用服务器错误,无法处理请求。 |
501 Not Implemented | 服务器不支持请求的方法。 |
502 Bad Gateway | 上游服务器返回无效响应。 |
503 Service Unavailable | 服务器暂时不可用,可能过载或维护中。 |
504 Gateway Timeout | 上游服务器响应超时。 |
📌 提示:合理使用 HTTP 状态码可以提高 API 的可读性和调试效率。