常见状态码总结

状态码定义

2xx

• 200 OK：表示服务器成功处理了客户端的请求，并返回所请求的数据。这是最常见的状态码，表示一切正常。
• 201 Created：表示服务器成功处理了客户端的 POST 请求，并在服务器上创建了新的资源。
• 204 No Content：表示服务器成功处理了客户端的请求，但没有返回任何内容。通常用于删除操作或只需确认请求的场景。
• 206 Partial Content：表示服务器成功处理了部分 GET 请求，通常在客户端进行文件下载时使用。服务器返回部分内容而不是整个资源，响应头中包含了 Content-Range，指定了返回的数据范围。

3xx

• 301 Moved Permanently：表示所请求的资源已永久移动到新的 URL，搜索引擎会将原始 URL 替换为新的 URL。浏览器在接收到 301 响应后会自动重定向到新的 URL。
• 302 Found（或称为 302 Moved Temporarily）：表示所请求的资源临时移动到新的 URL，与 301 类似，但是搜索引擎不会替换原始 URL。浏览器在接收到 302 响应后会自动重定向到新的 URL。
• 304 Not Modified：表示客户端发送了带有 If-Modified-Since 或 If-None-Match 头部的条件请求，但服务器判断请求资源未发生变化，因此返回 304 响应，客户端可以使用缓存的资源。

4xx

• 400 Bad Request：请求错误。

• 401 Unauthorized：未授权。（未验证 -- 没有验证信息或者验证失败）

• 403 Forbidden：禁止访问。（被拒绝 -- 理解该请求，但不被接受。相应的描述信息会说明原因。）

• 404 Not Found：未找到请求的资源。(经典 404)

• 405 Method Not Allowed：请求方法不允许。

• 408 Request Timeout：请求超时。

• 415 Unsupported Media Type：不支持的媒体类型。

5xx

• 500 Internal Server Error：服务器内部错误。

• 502 Bad Gateway：错误的网关。

• **503 Service Unavailable：服务不可用。**通常是因为服务器过载或正在维护

• 504 Gateway Timeout：网关超时。

状态码响应规范

• 200 一定是正确。所有异常都不使用 200 返回码

• 业务逻辑上的错误，有特别的错误码尽量使用 4xx，否则使用 400。

• 服务器端内部错误，无特别错误码使用 500。

• 业务异常时，返回内容使用 JSON 格式定义 error 信息。

学习参考

• [HTTP 状态码 (yuque.com)](https://jiguang-docs.yuque.com/staff-mg3p4r/phf69t/sgxglu?singleDoc# 《HTTP 状态码》)