HTTP状态码
状态码由3位数字和原因短语组成,例如:200 OK
数字中的第一位指定了响应类别,响应类别有以下5种:
类别 | 原因短语 | |
---|---|---|
1XX | Informational(信息性状态码) | 接收的请求正在处理 |
2XX | Success(成功状态码) | 请求正常处理完毕 |
3XX | Redirection(重定向) | 需要进行附加操作以完成请求 |
4XX | Client Error(客户端错误状态码) | 服务器无法处理请求 |
5XX | Server Error (服务器错误代码) | 服务器处理请求出错 |
200 OK
: 表示从客户端发来的请求在服务端被正常处理了。
204 No Content
: 请求处理成功,但没有资源可返回;
该状态码代表服务器接收的请求已经成功处理,但在返回的响应报文中不含实体的主体部分;
例如:从浏览器发出请求处理后,返回204响应,那么浏览器显示的页面不发生更新;
206 Partial Content
:该状态码表示客户端进行了范围请求,而服务器成功执行了这部分的GET请求;响应报文中包含了由Content-Range
指定范围的实体内容
301 Moved Permanently
: 永久性重定向;
该状态码表示请求的资源已被分配了新的URI,以后应使用资源现在所指的URI;
如果已经把资源对应的URI保存为书签了,这时应该按Location首部字段提示的URI重新保存;
302 Found
: 临时性重定向,该状态码表示请求的资源已被分配了新的URI,希望用户(本次)能使用新的URI访问;
303 See Other
:该状态码表示由于请求对应的资源存在着另一个URI,应使用GET方法定向获取请求的资源;
303状态码明确表示客户端应当采用GET方法获取资源;
301,302标准是禁止将POST方法改变成GET方法的;
注意: 当301,302,303响应状态码返回时,几乎所有的浏览器都会把POST改成GET,并删除请求报文内的主体,之后请求会自动再次发送;
304 Not Modified
:资源已找到,但未符合条件请求
该状态码表示客户端发送附带条件的请求时,服务器端允许请求访问资源,但未满足条件的情况;
304状态码返回时,不包含任何响应的主体部分。
307 Temporary Redirect
: 临时重定向;
该状态码与302 Found
有着相同的含义;302标准禁止POST变换成GET,但实际使用时大家并不遵守;
307会遵照浏览器标准,不会从POST变成GET;
400 Bad Request
: 该状态码表示请求报文中存在语法错误;当错误发生时,需要修改请求的内容后再次发送。另外,浏览器会像200 OK 一样对待该状态码
401 Unauthorized
: 该状态码表示发送的请求需要有通过HTTP认证(BASIC认证,DIGEST认证)的认证信息;
另外若之前已进行过1次请求,则表示用户认证失败
返回含有401的响应必须包含一个适用于被请求资源的WWW-Authenticate
首部用以质询用户信息。当浏览器初次接收到401响应,会弹出认证用的对话窗口
403 Forbidden
:该状态码表明对请求资源的访问被服务器拒绝了。
404 Not Found
:该状态码表明服务器上无法找到请求的资源。
除此之外,也可以在服务端拒绝请求且不想说明理由时使用。
500 Internal Server Error
:该状态码表明服务器端在执行请求时发生了错误。也有可能是应用存在的bug 或某些临时的故障
503 Service Unavailable
:该状态码表明服务器暂时处于超负载或正在进行停机维护,现在无法处理请求。
如果事先得知解除以上状况需要的时间,最好写入RetryAfter
首部字段再返回给客户端
注意: 状态码和状况不一致也是有可能发生的。
例如:Web应用程序内部发生错误,状态码依然返回200OK