HTTP状态码(HTTP Status Code),用以表示网页服务器超文本传输协议响应状态的3位数字代码。所有状态码的第一个数字代表了响应的五种状态之一。所示的消息短语是典型的,但是可以提供任何可读取的替代方案。除非另有说明,状态码是HTTP / 1.1标准(RFC 7231)的一部分。简单来讲,HTTP状态码的作用是服务器告诉客户端当前请求响应的状态,通过状态码就能判断和分析服务器的运行状态。
一、1XX(请求正在处理)
1XX:代表请求已被接受,需要继续处理。这类响应是临时响应,只包含状态行和某些可选的响应头信息,并以空行结束。常见的有:
100:(继续)客户端应当继续发送请求。这个临时响应是用来通知客户端它的部分请求已经被服务器接收,且仍未被拒绝。客户端应当继续发送请求的剩余部分,或者如果请求已经完成,忽略这个响应。服务器必须在请求完成后向客户端发送一个最终响应。
101:(切换协议)服务器已经理解了客户端的请求,并将通过Upgrade 消息头通知客户端采用不同的协议来完成这个请求。在发送完这个响应最后的空行后,服务器将会切换到在Upgrade 消息头中定义的那些协议。注意:只有在切换新的协议更有好处的时候才应该采取类似措施。例如,切换到新的HTTP 版本比旧版本更有优势,或者切换到一个实时且同步的协议以传送利用此类特性的资源。
二、2XX(请求成功处理)
2XX:代表成功处理了请求的状态代码。常见的有:
200:(成功) 服务器已成功处理了请求。通常,这表示服务器提供了请求的网页。
201:(已创建) 请求已经被实现,而且有一个新的资源已经依据请求的需要而建立,且其 URI 已经随Location 头信息返回。假如需要的资源无法及时建立的话,应当返回 '202'。
202:(已接受) 服务器已接受请求,但尚未处理。正如它可能被拒绝一样,最终该请求可能会也可能不会被执行。在异步操作的场合下,没有比发送这个状态码更方便的做法了。
203:(非授权信息) 服务器已成功处理了请求,但返回的实体头部元信息不是在原始服务器上有效的确定集合,而是来自本地或者第三方的拷贝。当前的信息可能是原始版本的子集或者超集。
204:(无内容) 服务器成功处理了请求,但不需要返回任何实体内容,并且希望返回更新了的元信息。响应可能通过实体头部的形式,返回新的或更新后的元信息。如果存在这些头部信息,则应当与所请求的变量相呼应。
205:(重置内容) 服务器成功处理了请求,且没有返回任何内容。但是与204响应不同,返回此状态码的响应要求请求者重置文档视图。该响应主要是被用于接受用户输入后,立即重置表单,以便用户能够轻松地开始另一次输入。
206:(部分内容) 服务器已经成功处理了部分 GET 请求。类似于 FlashGet 或者迅雷这类的 HTTP下载工具都是使用此类响应实现断点续传或者将一个大文档分解为多个下载段同时下载。
三、3XX(表示重定向)
3XX:代表要完成请求,需要进一步操作。通常,这些状态代码用来重定向。常见的有:
300:(多种选择) 被请求的资源有一系列可供选择的回馈信息,每个都有自己特定的地址和浏览器驱动的商议信息。用户或浏览器能够自行选择一个首选的地址进行重定向。
301:(永久移动) 请求的网页已永久移动到新位置。服务器返回此响应(对 GET 或 HEAD 请求的响应)时,会自动将请求者转到新位置。
302:(临时移动) 服务器目前从不同位置的网页响应请求,但请求者应继续使用原有位置来进行以后的请求。
303:(查看其他位置) 请求者应当对不同的位置使用单独的 GET 请求来检索响应时,服务器返回此代码。
304:(未修改) 如果客户端发送了一个带条件的 GET 请求且该请求已被允许,而文档的内容(自上次访问以来或者根据请求的条件)并没有改变,则服务器应当返回这个状态码。304响应禁止包含消息体,因此始终以消息头后的第一个空行结尾。
305:(使用代理) 请求者只能使用代理访问请求的网页。如果服务器返回此响应,还表示请求者应使用代理。
306:在最新版的规范中,306状态码已经不再被使用。
307:(临时重定向)请求的资源临时从不同的URI 响应请求。
四、4XX(表示请求错误)
4XX:表示请求可能出错,妨碍了服务器的处理。常见的有:
400:(错误请求):语义有误,当前请求无法被服务器理解。除非进行修改,否则客户端不应该重复提交这个请求;或是请求参数有误。
401:(未授权):当前请求需要用户验证。对于需要登录的网页,服务器可能返回此响应。
403:(禁止):服务器已经理解请求,但是拒绝执行它。与401响应不同的是,身份验证并不能提供任何帮助,而且这个请求也不应该被重复提交。
404:(未找到):请求失败,请求所希望得到的资源未被在服务器上发现。
405:(方法禁用):请求行中指定的请求方法不能被用于请求相应的资源。
406:(不接受):请求的资源的内容特性无法满足请求头中的条件,因而无法生成响应实体。
407:(需要代理授权):与401响应类似,只不过客户端必须在代理服务器上进行身份验证。代理服务器必须返回一个 Proxy-Authenticate 用以进行身份询问。客户端可以返回一个 Proxy-Authorization 信息头用以验证。
408:(请求超时):请求超时。客户端没有在服务器预备等待的时间内完成一个请求的发送。
五、5XX(表示服务器错误)
5XX:表示服务器在尝试处理请求时发生内部错误。这些错误可能是服务器本身的错误,而不是请求出错。常见的有:
500:(服务器内部错误):服务器遇到了一个未曾预料的状况,导致了它无法完成对请求的处理。一般来说,这个问题都会在服务器端的源代码出现错误时出现。
501:(尚未实施):服务器不支持当前请求所需要的某个功能。当服务器无法识别请求的方法,并且无法支持其对任何资源的请求。
502:(错误网关):作为网关或者代理工作的服务器尝试执行请求时,从上游服务器接收到无效的响应。
503:(服务不可用):由于临时的服务器维护或者过载,服务器当前无法处理请求。这个状况是临时的,并且将在一段时间以后恢复。
504:(网关超时):作为网关或者代理工作的服务器尝试执行请求时,未能及时从上游服务器(URI标识出的服务器,例如HTTP、FTP、LDAP)或者辅助服务器(例如DNS)收到响应。
505:(HTTP 版本不受支持):服务器不支持,或者拒绝支持在请求中使用的 HTTP 版本。这暗示着服务器不能或不愿使用与客户端相同的版本。响应中应当包含一个描述了为何版本不被支持以及服务器支持哪些协议的实体。
六、日常适用场景
一些常见状态码的适用场景:
100
客户端应当继续发送请求。这个临时响应是用来通知客户端它的部分请求已经被服务器接收,且仍未被拒绝。服务端收到请求,并表示可以继续。在客户端准备推送较大的数据时,可以用 100 表示允许。
206
服务器已经成功处理了部分 GET 请求。类似于 FlashGet 或者迅雷这类的 HTTP下载工具都是使用此类响应实现断点续传或者将一个大文档分解为多个下载段同时下载。
301
永久重定向。请求的资源被永久移动到其他位置。假如我们的一篇博客的 url 地址发生了永久的改变,但用户收藏夹里的链接还是旧的,我们就可以在用户请求旧链接时,返回 301 状态码,并赋上一个重定向地址。
302
临时重定向。原始描述短语为 Moved Temporarily。适合一些临时的重定向操作,比如因为服务器崩溃导致一些页面无法提供正确的访问,在修复期间,则可以通过 302 先暂时地重定向到一个新的地址。修复完后再让用户继续访问原链接。302 不会持久缓存,但可以设置缓存时间持续一段时间。
403
服务器已经理解请求,但是拒绝执行它。与401响应不同的是,身份验证并不能提供任何帮助,而且这个请求也不应该被重复提交。
404
请求失败,请求所希望得到的资源未被在服务器上发现。广为人知的状态码,代表 url 对应资源不存在。比如一些文章被删除,是直接在数据库中进行不可逆地彻底删除的。然后就导致用户访问这个页面时,服务器找不到对应数据,然后就返回一个 404,并提示 “页面不存在”。
503
由于临时的服务器维护或者过载,服务器当前无法处理请求。这个状况是临时的,并且将在一段时间以后恢复。
504
网关超时。网关还在,但后端服务因为各种原因(比如因为一个死循环卡死了),导致一直没有响应回来,在过了一段时间后网关了依旧没能收到消息,就会给客户端返回 504 网关超时。
总结
状态码可以分为5类:
1XX表示请求正在处理;
2XX表示请求已经成功处理;
3XX表示重定向;
4xx表示请求错误;
5xx表示服务器错误。