HTTP Status Code

gaunthan Posted on Jan 25 2017

? HTTP ? ? Application Layer ? ? Computer Networking ?

## 作用
状态码的职责是当客户端向服务器端发送请求时，描述返回的请求结果。借助状态码，用户可以知道服务器端是正常处理了请求，还是出现了错误。

## 格式与类别
状态码如200 OK，由**3位数字**和**原因短语**组成。数字中的第一位指定了响应类别，后两位无分类。响应类别有以下5种：

|状态码|类别|原因短语|
|--|
|1XX|Informational（信息性状态码）|接受的请求正在处理。|
|2XX|Success（成功状态码）|请求正常处理完毕。|
|3XX|Redirection（重定向状态码）|需要进行附加操作以完成请求。|
|4XX|Client Error（客户端错误状态码）|服务器无法处理请求。|
|5XX|Server Error（服务器错误状态码）|服务器处理请求出错。|

### 2XX 成功
|状态码与原因短语|释义|
|--| 
|200 OK|表示从客户端发来的请求在服务器端被正常处理了。|
|204 No Content|该状态码代表服务器接受的请求已成功处理，但在返回的响应报文中不含实体的主体部分。另外，也不允许返回任何实体的主体。比如，当从流弹起发出请求处理后，返回204响应，那么浏览器显示的页面不发生更新。一般在只需从客户端往服务器发送信息，而对客户端不需要发送新信息内容的情况下使用。|
|206 Partial Content|该状态码表示客户端进行了范围请求，而服务器成功执行了这部分的GET请求。响应报文中包含由Content-Range指定范围的实体内容。|

### 3XX 重定向
|状态码与原因短语|释义|
|--|
|301 Moved Permanently|永久性重定向。该状态码表示请求的资源已被分配了新的URI，以后应使用资源现在所指的URI。|
|302 Found|临时性重定向。该状态码表示请求的资源已被分配了新的URI，希望用户（本次）能使用新的URI访问。|
|303 See Other|该状态码表示由于请求对应的资源存在着另一个URI，应使用GET方法定向获取请求的资源。|
|304 Not Modified|该状态码表示客户端发送附带条件的请求时，服务器端允许请求访问资源，但因发送请求未满足条件的情况后，直接返回304 Not Modified（服务器端资源未改变，可直接使用客户端未过期的缓存）。304状态码返回时，不包含任何响应的主体部分。|
|307 Temporary Redirect|临时重定向。该状态码与302 Found有着相同的含义。|

当301、302、303响应状态码返回时，几乎所有的浏览器都会把POST改成GET，并删除请求报文内的主体，之后请求会自动再次发送。

### 4XX 客户端错误
|状态码与原因短语|释义|
|--|
|400 Bad Request|该状态码表示请求报文中存在语法错误。当错误发送时，需修改请求的内容后再次发送请求。|
|401 Unauthorized|该状态码表示发送的请求需要有通过HTTP认证（BASIC认证、DIGEST认证）的认证信息。另外若之前已进行过1次请求，则表示用户认证失败。返回含有401的响应必须包含一个适用于被请求资源的`WWW-Authenticate`首部用以**质询**（challenge）用户信息。当浏览器初次接收到401响应，会弹出认证用的对话窗口。
|403 Forbidden|该状态码表明对请求资源的访问被服务器拒绝了。服务器端没有必要给出拒绝的详细理由，但如果想作说明的话，可以在实体的主体部分对原因进行描述，这样就能让用户看到了。未获得文件系统的访问权限，访问权限出现某些问题（从未授权的发送源IP地址试图访问）等列举的情况都可能是发生403的原因。|
|404 Not Found|该状态码表明服务器上无法找到请求的资源。除此之外，也可以在服务器端拒绝请求且不想说明理由时使用。|

### 5XX 服务器错误
|状态码与原因短语|释义|
|--|
|500 Internal Server Error|该状态码表明服务器端在执行请求时发生了错误。也有可能是Web应用存在的bug或某些临时的故障。|
|503 Service Unavailable|该状态码表明服务器暂时处于超负载或正在进行停机维护，现在无法处理请求。如果事先得知解除以上状况需要的时间，最好写入`Retry-After`首部字段再返回给客户端。|

## References

- 上野 · 宣 著, 于均良. 图解 HTTP[M]. 人民邮电出版社, 2014.

comments powered by Disqus