返回结果的 HTTP 状态码

1. 状态码告知从服务器端返回的处理结果

状态码的职责是当客户端向服务器发送请求时，描述返回的请求结果。

状态码描述请求.png

状态码如 200 OK，以 3 位数字和原因短语组成。

数字中第一位指定了响应类别，后两位无分类。响应类别有以下五种。

2. 2XX 成功

2XX 的响应结果表明请求被正常处理了。

• 200 OK

  200 Ok.png

  表示从客户端发来的请求在服务器端被正常处理了。

• 204 No Content

  204.png

  该状态码代表服务器接受的请求已成功处理，但在返回的响应报文中不包含实体的主体部分，也不允许返回任何实体的主体。

  一般在只需要客户端往服务器发送消息，而对客户端不需要发送新消息内容的情况下调用。

• 206 Partial Content

  206.png

  该状态码表示客户端进行了范围请求，而服务器成功执行了这部分的 GET 请求。响应报文中包含由 Content-Range 指定范围的实体内容。

3. 3XX 重定向

3XX 响应结果表明浏览器需要执行某些特殊的处理以正确处理请求。

• 301 Moved Permanently

  301.png

  永久性重定向，该状态码表示请求的资源已被分配了新的 URI，以后应使用资源现在所指的 URI。

• 302 Found

  302.png

  临时性重定向，改状态码表示请求的资源已被分配了新的 URI，希望用户能使用新的 URI 访问。

  302 状态码代表的资源不是被永久移动，只是临时性质的。已移动的资源对应的 URI 将来还有可能发生变化。

• 303 See Other

  303.png

  该状态码表示由于请求对应的资源存在着另一个 URI，应使用 GET 方法定向获取请求的资源。

  303 状态码 和 302 状态码有着相同的功能，区别在于 303 状态码明确表示客户端应采用 GET 方法获取资源。

• 304 Not Modified

  304.png

  该状态码表示客户端发送附带条件的请求时，服务器端允许请求访问资源。但未满足条件的情况，304 状态码返回时，不包含任何响应的主体部分。

  附带条件的请求是指采用 GET 方法的请求报文中包含 If-Match、If-Modified-Since、If-None-Match、If-Range、If-Unmodified-Since 中任一首部。

  注： 304 状态码和重定向无关。

• 307 Temporary Redirect

  临时重定向，与 302 Found 有着相同的含义。尽管 302 标准禁止 POST 变化成 GET，但实际使用并不遵守，307 会遵照浏览器标准，不会从 POST 变成 GET。

4. 4XX 客户端错误

4XX 的响应结果表明客户端是发生错误的原因所在。

• 400 Bad Request

  400.png

  改状态码表示请求报文中存在语法错误，当错误发生时，需要修改请求的内容后再次发送请求。

• 401 Unauthorized

  401.png

  该状态码表示发送的请求需要有通过 HTTP 认证（BASIC 认证、DIGEST 认证）的认证消息。另外若之前已进行过一次 1 次请求，则表示用户认证失败。

  返回含有 401 的响应必须包含一个适用于被请求资源的 WWW-Authenticate 首部用以质询（challenge)用户消息。当浏览器初次接受到 401 响应，会弹出认证用的对话窗口。

• 403 Forbidden

  403.png

  该状态码表明对请求资源的访问被服务器拒绝了。

• 404 Not Found

  404.png

  该状态码表示服务器上无法找到请求的资源。除此之外，也可以在服务器端拒绝请求并且不想说明理由时使用。

5. 5XX 服务器错误

5XX 的响应结果表明服务器本身发生错误。

• 500 Internal Server Erroor

  500.png

  该状态码表明服务器端在执行请求时发生了错误，也有可能是 Web 应用存在的 bug 或某些临时的故障。

• 503 Service unavailable

  503.png

  该状态码表明服务器暂时处于超负载或正在进行停机维护，现在无法处理请求。