HTTP响应状态码

HTTP响应状态码

    HTTP状态码(HTTP Status Code)是用以表示Web服务器HTTP响应状态的3位数字代码,合理的状态码不仅可以让用户或者浏览器做出更加合适的进一步操作,而且可以让客户端代码更加易于理解和维护。

  HTTP状态码分为5类:1xx表示继续发送请求;2xx表示请求成功;3xx表示资源已找到但需要继续进行其他操作; 4xx表示客户端错误;5xx表示服务器错误。下面就具体详述常见状态码的语义,及其使用方式。

1XX

  1xx表示请求已被接受,但需要后续处理

100(Continue)

  客户端应继续发送请求。

101(Switching Protocols)

  需要切换协议,服务器通过的Upgrade响应头字段通知客户端。

2XX

  请求已成功被服务器接收、理解、并接受。

200(OK)

  请求已成功,请求所希望的响应头或数据体将随此响应返回。

201(Created)

  请求已经被实现,而且有一个新的资源已经依据请求的需要而创建。在RESTFul风格的URL设计中,通常响应POST请求。

202(Accepted)

  服务器已经接受请求,但尚未处理。比如POST一个资源应当返回201,但由于性能原因未能立即创建,可以返回202。

203(Non-Authoritative Information)

  服务器已成功处理了请求,但返回的实体头部元信息不是在原始服务器上有效的确定集合,而是来自本地或者第三方的拷贝。当前的信息可能是原始版本的子集或者超集。例如,包含资源的元数据可能导致原始服务器知道元信息的超集。使用此状态码不是必须的,而且只有在响应不使用此状态码便会返回200 OK的情况下才是合适的。

204(No Content)

  服务器成功处理了请求,但不需要返回任何实体内容,204响应禁止包含任何消息体。浏览器收到该响应后不应产生文档视图的变化。

205(Reset Content)

  服务器成功处理了请求,但不需要返回任何实体内容,205响应禁止包含任何消息体。 与204不同的是,返回此状态码的响应要求请求者重置文档视图。比如用户刚刚提交一个表单,返回205后页面重置,用户可以立即填写下一个表单。

206(Partial Content)

  HTTP协议允许分片传输。请求头中包含Range字段时,响应需要只返回Range指定的那一段。响应中应包含Content-Range来指示返回内容的范围。

207(Multi-Status)

  之后的消息体将是一个XML消息,并且可能依照之前子请求数量的不同,包含一系列独立的响应代码。

3XX

  这类状态码代表需要客户端采取进一步的操作才能完成请求。通常,这些状态码用来重定向, 重定向目标在本次响应的Location头字段中指明。

300(Multiple Choices)

  表示多种选择。请求的资源可包括多个位置,相应可返回一个资源特征与地址的列表用于用户终端(例如:浏览器)选择。

  被请求的资源有一系列可供选择的回馈信息,每个都有自己特定的地址和浏览器驱动的商议信息。用户或浏览器能够自行选择一个首选的地址进行重定向。

  除非这是一个 HEAD 请求,否则该响应应当包括一个资源特性及地址的列表的实体,以便用户或浏览器从中选择最合适的重定向地址。这个实体的格式由 Content-Type 定义的格式所决定。浏览器可能根据响应的格式以及浏览器自身能力,自动作出最合适的选择。当然,RFC 2616规范并没有规定这样的自动选择该如何进行。

  如果服务器本身已经有了首选的回馈选择,那么在 Location 中应当指明这个回馈的 URI;浏览器可能会将这个 Location 值作为自动重定向的地址。此外,除非额外指定,否则这个响应也是可缓存的。

301(Moved Permanently)

  被请求的资源已永久移动到新位置,并且将来任何对此资源的引用都应该使用本响应返回的若干个URI之一。如果该请求不是GET/HEAD, 浏览器通常会要求用户确认重定向。

  301通常用于网站迁移时,服务器对旧的URL进行301重定向到新的URL。这样搜索引擎可以正确地更新原有的页面排名等信息。

302(Found)

  请求的资源现在临时从不同的URI响应请求。除非指定了Cache-ControlExpires,否则该响应不可缓存。 如果当前请求非HEAD或GET,浏览器需取得用户确认,再进行重定向。

303(See Other)

  对应当前请求的响应可以在另一个URI上被找到,而且客户端应当采用GET的方式访问那个资源。 这个方法的存在主要是为了允许由脚本激活的POST请求输出重定向到一个新的资源。

  303响应禁止被缓存。

304(Not Modified)

  如果客户端发送了一个带条件的GET请求且该请求已被允许,而文档的内容(自上次访问以来或者根据请求的条件)并没有改变。

  304响应禁止包含消息体。

  304响应也是一种缓存机制。Web服务器对静态资源文件通常会采取缓存,因此在Web开发中你可以看到大量的304响应。 服务器给出的响应中通常会包含Etag来标识资源ID,例如:

ETag: "686897696a7c876b7e"

  客户端在下次访问同一URL时会设置头字段If-None-Match(这是一个请求条件):

If-None-Match: "686897696a7c876b7e"

  服务器返回资源前会判断Etag是否与客户端提供的If-None-Match匹配,如果匹配则说明资源未发生改变,此时应返回304.

305(Use Proxy)

  被请求的资源必须通过指定的代理才能被访问。Location 域中将给出指定的代理所在的 URI 信息,接收者需要重复发送一个单独的请求,通过这个代理才能访问相应资源。只有原始服务器才能建立305响应。

306(Switch Proxy)

  不再使用。废除了,对,就是废除了,别瞎想。

307(Temporary Redirect)

  请求的资源临时从不同的URI 响应请求,临时重定向。与302类似。使用GET请求重定向。

  新的临时性的URI 应当在响应的 Location 域中返回。除非这是一个HEAD 请求,否则响应的实体中应当包含指向新的URI 的超链接及简短说明。因为部分浏览器不能识别307响应,因此需要添加上述必要信息以便用户能够理解并向新的 URI 发出访问请求。

  如果这不是一个GET 或者 HEAD 请求,那么浏览器禁止自动进行重定向,除非得到用户的确认,因为请求的条件可能因此发生变化。

4XX

  这类的状态码代表了客户端看起来可能发生了错误,妨碍了服务器的处理。 除非响应的是一个HEAD请求,否则服务器就应该返回一个解释当前错误状况的实体。

400(Bad Request)

  由于包含语法错误,当前请求无法被服务器理解。

  400通常在服务器端表单验证失败时返回。

401(Unauthorized)

  当前请求需要用户验证,响应中会包含一个WWW-Authenticate字段来询问用户的授权信息。 而客户端的下次请求需要提供包含Authorization头的请求。

402(Payment Required)

  HTTP Basic Auth就是这样实现的。当服务器返回401时浏览器会弹出窗口:

  输入验证信息并点击确定,浏览器会根据你的输入填写Authorization头并重新发送请求。对于Basic Auth看起来是这样的:

Authorization:Basic eWFuZ2p2bjp5YW5nanZuaGFydA==

403(Forbidden)

  服务器已经理解请求,但是拒绝执行它。与401响应不同的是,身份验证并不能提供任何帮助。

  403和401一样,需要在相应消息体中需要给出原因。除非是一个HEAD请求。

  通常用于服务器已经知道用户的身份的情况。比如从请求的Cookie得到的Session中可以得知当前用户无权进行该操作。 通常的Web应用中,对于401的情况应当重定向至登录页面,403的情况应当直接告知错误(这属于前端Bug)。

404(Not Found)

  请求所希望得到的资源未被在服务器上发现。

  当通常用于当服务器不想揭示到底为何请求被拒绝时,比如应当返回500时服务器不愿透露自己的错误。

405(Method Not Allowed)

  请求行中指定的请求方法不能被用于请求相应的资源。

  在Web开发中通常是因为客户端和服务器的方法不一致,比如客户端通过PUT来修改一个资源,而服务器把它实现为POST方法。

  开发中统一规范就好了。

406(Not Acceptable)

  请求的资源的内容特性无法满足请求头中的条件,因而无法生成响应实体。

  除非这是一个 HEAD 请求,否则该响应就应当返回一个包含可以让用户或者浏览器从中选择最合适的实体特性以及地址列表的实体。实体的格式由 Content-Type 头中定义的媒体类型决定。浏览器可以根据格式及自身能力自行作出最佳选择。但是,规范中并没有定义任何作出此类自动选择的标准。

407(Proxy Authentication Required)

  与401响应类似,只不过客户端必须在代理服务器上进行身份验证。代理服务器必须返回一个 Proxy-Authenticate 用以进行身份询问。客户端可以返回一个 Proxy-Authorization 信息头用以验证。

408(Request Time-out)

  请求超时。

  客户端没有在服务器预备等待的时间内完成一个请求的发送。客户端可以随时再次提交这一请求而无需进行任何更改。

409(Conflict)

  由于和被请求的资源的当前状态之间存在冲突,请求无法完成。

  这个代码只允许用在这样的情况下才能被使用:用户被认为能够解决冲突,并且会重新提交新的请求。该响应应当包含足够的信息以便用户发现冲突的源头。

  冲突通常发生于对 PUT 请求的处理中。例如,在采用版本检查的环境下,某次 PUT 提交的对特定资源的修改请求所附带的版本信息与之前的某个(第三方)请求相冲突,那么此时服务器就应该返回一个409错误,告知用户请求无法完成。此时,响应实体中很可能会包含两个冲突版本之间的差异比较,以便用户重新提交归并以后的新版本。

410(Gone)

  被请求的资源在服务器上已经不再可用,而且没有任何已知的转发地址。这样的状况应当被认为是永久性的。如果可能,拥有链接编辑功能的客户端应当在获得用户许可后删除所有指向这个地址的引用。如果服务器不知道或者无法确定这个状况是否是永久的,那么就应该使用404状态码。除非额外说明,否则这个响应是可缓存的。

  410响应的目的主要是帮助网站管理员维护网站,通知用户该资源已经不再可用,并且服务器拥有者希望所有指向这个资源的远端连接也被删除。这类事件在限时、增值服务中很普遍。同样,410响应也被用于通知客户端在当前服务器站点上,原本属于某个个人的资源已经不再可用。当然,是否需要把所有永久不可用的资源标记为'410 Gone',以及是否需要保持此标记多长时间,完全取决于服务器拥有者。

411(Length Required)

  服务器拒绝在没有定义 Content-Length 头的情况下接受请求。在添加了表明请求消息体长度的有效 Content-Length 头之后,客户端可以再次提交该请求。

412(Precondition Failed)

   服务器在验证在请求的头字段中给出先决条件时,没能满足其中的一个或多个。这个状态码允许客户端在获取资源时在请求的元信息(请求头字段数据)中设置先决条件,以此避免该请求方法被应用到其希望的内容以外的资源上。

413(Request Entity Too Large)

  服务器拒绝处理当前请求,因为该请求提交的实体数据大小超过了服务器愿意或者能够处理的范围。

  一般的服务器都会设置HTTP请求消息体的最大长度,当然这是一种阻挡攻击的手段。 例如你在使用HTTP方式来访问Git仓库,如果你在仓库中加入了大的二进制文件(通常为目标文件或多媒体文件), 在Push时服务器很可能会返回413错误。如果切换为ssh协议就不会有这样的问题了,服务器只能限制整个仓库的大小。

414(Request-URI Too Large)

  当URI太长时,服务器可以返回414.

   当HTTP协议并未规定URI应当有多长。这取决于浏览器和服务器的设置, 在服务器中当然你想设置多长都可以,但是浏览器是你决定不了的,而且不同的厂商在采用不同的长度限制,可以认为最短的是2K:

  The limit is in MSIE and Safari about 2KB, in Opera about 4KB and in Firefox about 8KB, (255 bytes if we count very old browsers) .

  当然URI长度的这一点限制会使得HTTP GET方法的能力有限,不能传输超过2K的数据。另外因为GET方法的所有数据都体现在URI上, 对于用户是可见的。这一点不太安全。

  其实HTTP POST传输数据理论上并不比GET安全更多,因为POST的Entity Body也是明文传输的。只是GET的数据用户直接可见而已。

415(Unsupported Media Type)

  对于当前请求的方法和所请求的资源,请求中提交的实体并不是服务器中所支持的格式,因此请求被拒绝。

416(Requested range not satisfiable)

  如果请求中包含了 Range 请求头,并且 Range 中指定的任何数据范围都与当前资源的可用范围不重合,同时请求中又没有定义 If-Range 请求头,那么服务器就应当返回416状态码。

  假如 Range 使用的是字节范围,那么这种情况就是指请求指定的所有数据范围的首字节位置都超过了当前资源的长度。服务器也应当在返回416状态码的同时,包含一个 Content-Range 实体头,用以指明当前资源的长度。这个响应也被禁止使用 multipart/byteranges 作为其 Content-Type。

417(Expectation Failed)

  在请求头 Expect 中指定的预期内容无法被服务器满足,或者这个服务器是一个代理服务器,它有明显的证据证明在当前路由的下一个节点上,Expect 的内容无法被满足。

5XX

  这类状态码代表了服务器在处理请求的过程中有错误或者异常状态发生,也有可能是服务器意识到以当前的软硬件资源无法完成对请求的处理。 并且响应消息体中应当给出理由,除非是HEAD请求。

500(Internal Server Error)

  通常是代码出错,后台Bug。一般的Web服务器通常会给出抛出异常的调用堆栈。 然而多数服务器即使在生产环境也会打出调用堆栈,这显然是不安全的。

501(Not Implemented)

  服务器不支持当前请求所需要的某个功能。

  当服务器无法识别请求的方法,并且无法支持其对任何资源的请求。

502(Bad Gateway)

   作为网关或者代理工作的服务器尝试执行请求时,从上游服务器接收到无效的响应。

  如果你在用HTTP代理来FQ,或者你配置了nginx来反向代理你的应用,你可能会常常看到它。

503(Service Unavailable)

   由于临时的服务器维护或者过载,服务器当前无法处理请求。这个状况是临时的,并且将在一段时间以后恢复。如果能够预计延迟时间,那么响应中可以包含一个 Retry-After 头用以标明这个延迟时间。如果没有给出这个 Retry-After 信息,那么客户端应当以处理500响应的方式处理它。

  注意:503状态码的存在并不意味着服务器在过载的时候必须使用它。某些服务器只不过是希望拒绝客户端的连接。

 504(Gateway Time-out)

  作为网关或者代理工作的服务器尝试执行请求时,未能及时从上游服务器收到响应。

  注意与502的区别:

    502是接收到了无效响应比如Connection Refused

    504是响应超时,通常是被墙了。

  很多国外站点都会使用CDN来Serve静态文件,但我大中华墙掉了一些CDN。导致这些资源文件的请求会一直处于Pending状态直到超时。 表现为浏览器显示空白页面,长时间处于等待状态。这时在控制台看到HTML已经载入了就可以点击停止按钮了,停止载入那些资源。 页面会立即显示出来,虽然样式和交互可能有问题。

 

参考文章

如何理解HTTP响应的状态码?

203

207

posted @ 2019-06-12 10:34  AKA绒滑服贵  阅读(862)  评论(0编辑  收藏  举报