状态码用于描述响应状态。借助状态码,用户可以知道服务器端是正常处理了请求还是出现了错误。
状态码由三位数字和原因短语组成。
数字中的第一位指定了响应类别,响应类别有5种:
1XX Informational 信息性
接受的请求正在处理2XX Success 成功
请求正常处理完毕3XX Redirection 重定向
需要进行附加操作以完成请求4XX Client Error 客户端错误
服务器无法处理请求5XX Server Error 服务器错误
服务器处理请求出错
只要遵循状态码类别的定义,即使改变RFC中定义的状态码,或服务器自行创建状态码都没问题。
接下来介绍具有代表性的14个状态码。
2XX成功
2XX的响应结果表明请求被正常处理了。
200 OK
表示从客户端发来的请求在服务器端被正常处理了。
在响应报文内,随状态码一起返回的信息会因方法的不同而发生改变。使用GET方法时对应请求资源的实体会作为响应返回;而使用HEAD方法时,对应请求资源的实体主体部分不会被返回,而是只返回首部。
204 No Content
该状态码表示服务器接收的请求已成功处理,但在返回的响应报文中不含实体的主体部分。另外,也不允许返回任何实体的主体。
比如,当从浏览器发出请求处理后,返回204响应,那么浏览器显示的页面不会发生更新。
一般在只需要从客户端往服务器发送信息,而服务器对客户端不需要发送新信息内容的情况下使用。
206 Partial Content
该状态码表示客户端进行了范围请求,而服务器成功执行了这部分的GET请求。
响应报文中包含由Content-Range指定范围的实体内容。
3XX重定向
3XX响应结果表明浏览器需要指定某些特殊的处理以正确处理请求。
301 Moved Permanently
永久性重定向。该状态码表示请求的资源已被分配了新的URI,以后应使用资源现在所指的URI。
302 Found
临时性重定向。该状态码表示请求的资源已被分配了新的URI,希望用户本次能使用新的URI访问。
和301类似,但是302状态码所代表的资源不是永久性移动,只是临时性质的。
303 See Other
该状态码表示由于请求对应的资源存在着另一个URI,应使用GET方法定向获取请求的资源。
303和302有着相同的功能,但303明确表示客户端应采用GET方法获取资源。
当301,302,303响应状态码返回时,几乎所有的浏览器都会把POST改成GET,并删除请求报文内的主体,之后请求会自动再次发送。
301,302标准是禁止将POST方法改为GET方法的,但实际中大家都会这么做。
304 Not Modified
如果客户端发送了一个带条件的GET请求且该请求已被允许,而文档的内容(自上次访问以来或者根据请求的条件)并没有改变,则服务器应当返回这个状态码。代表服务器端资源未改变,可直接使用客户端未过期的缓存。
304状态码返回时,不包含任何响应的主体部分。
304其实和重定向没有什么关系……
307 Temporary Redirect
临时重定向。与302有着相同的含义。
307会遵照浏览器标准,不会从POST变成GET。
4XX 客户端错误
4XX的响应结果表明客户端是发生错误的原因所在
400 Bad Request
该状态码表示请求报文中存在语法错误。
当错误发生时,需修改请求的内容后再次发送请求。
另外,浏览器会像对待200 OK一样对待该状态码。
401 Unauthorized
该状态码表示发送的请求需要有通过HTTP认证的认证信息。
返回含有401的响应必须包含一个适用于被请求资源的www-Authenticate首部以质询用户信息。当浏览器初次接收到401响应,会弹出认证用的对话窗口。
403 Forbidden
该状态码表明对请求资源的访问被服务器拒绝了。服务器端没有必要给出拒绝的详细理由,但如果想说明的话,可以在实体的主体部分对原因进行描述。
未获得文件系统的访问授权,访问权限出现某些问题等情况都可能是发生403的原因。
404 Not Found
该状态码表示服务器上无法找到请求的资源。
除此之外,也可以在服务器端拒绝请求且不想说明理由时使用。
5XX 服务器错误
5XX的响应结果表明服务器本身发生错误。
500 Internal Server Error
该状态码表明服务器端在执行请求时发生了错误。
有可能是Web应用存在的bug或是某些临时的故障。
503 Service Unavailable
该状态码表明服务器暂时处于超负载或正在进行停机维护,现在无法处理请求。
如果事先得知解决以上状况需要的时间,最好写入Retry-After首部字段再返回给客户端。
注意,状态码和状况可能不一致。比如web应用程序内部发生错误,状态码依然返回200OK,这种情况也不是没有的。