如何选择正确的HTTP状态码

本文来源于我在InfoQ中文站翻译的文章,原文地址是:http://www.infoq.com/cn/news/2015/12/how-to-choose-http-status-code

众所周知,每一个HTTP响应都会带有一个状态码,不过对于很多开发者来说,平时使用最多的几个状态码无外乎就是200、400、404、500等。那其他众多状态码该应用在何种场景中,什么时候应该使用哪些状态码就成为一个值得我们深入思考的问题了。即便在Facebook这样的公司中,那些聪明的开发者所构建的API也可能只返回200。为此,Michael Kropat专门撰文分析了各个状态码的适用场景,以及我们为何要如此细致地区分不同状态码,同时还谈及了这么做的好处。

有什么是比返回一个HTTP状态码还要简单的事情呢?页面渲染了么?如果渲染,那就返回200呗。页面不存在?那就是404。需要将用户重定向到另外一个页面?那就使用302,也许301也行。

一切都是如此简单,不过当有人跟你说,你并没有以REST的方式做事情,你可能就要警醒了。新资源是否返回了RFC兼容、Roy-Fielding建议的状态码?只会是200么?也许是204 No Content、202 Accepted,抑或是201 Created?

问题在于官方HTTP/1.1指南(RFC)最初是在1997年发布的。那时的我们还在使用Netscape Navigator、33.6kbps的调试解调器网上冲浪呢。这就好比是在现代商业战略中使用孙子兵法一样。这些宝贵的建议并不会随着时间的流逝而发生变化。不过,我们需要真正理解他们。

如果有可视化的决策树就好了,它可以帮助你快速识别与你的情况相吻合的状态码,这样就能忽略掉那些不相关的了。请看下图。

上图看起来是显而易见的,不过我发现很多人都会陷入其中,并且提出诸如“这种情况应该使用503 Service Unavailable还是404 Not Found呢”?停。如果你在完全不同的响应类别中思考具体的状态码,那就表明你的做法是完全错误的。再来看看上面这张图。

在继续之前我提出几点:

  • 你不必非得听我的,请直接查看RFC 7231httpstatuses.com
  • 我所面向的读者是那些创建网站或是使用REST API的开发者
  • 我将响应码大致划分为3大类

最后再提一点:我其实并没有什么资格就这个主题发表自己的看法,我只不过阅读过一些RFC并开发过一些APIs而已。如果觉得我说的不对,或是没有使用你倾向于使用的状态码,那么请在文末的评论中指出来,大家一起讨论。

2XX/3XX

4XX

5XX

为何说状态码很重要

虽说Facebook中很多聪明的开发者在构建APIs时只返回200,但我想说的是,状态码确实是非常重要的。现有的状态码对于现代网站/API来说有些太宽泛了。如果响应要以应用特定的格式来包含一些细节信息,比如说哪些字段验证失败了,原因是什么,这样可以让客户端以更加有意义的方式来处理响应。既然如此,那为何不多花点时间来研究一下那些“不太常用”的HTTP状态码呢?

在谈及为何说使用具体的状态码是非常重要的时候,人们很爱提到的一个原因就是HTTP是个分层系统,客户端与服务器之间可能存在着代理、缓存或是其他HTTP库,如果响应码有意义,那会让这一切都工作地更好。不过,我觉得这个解释站不住脚,比如说未来大家都使用上了HTTPS,我们也禁用掉了所有代理与缓存结点,你能说这时状态码就没用了么?

这里,我想谈谈我认为状态码依然很重要的3点原因:

1. 客户端可以针对不同的状态码采取不同的行为(或是可以轻松扩展以应对):

  • 301 Moved Permanently与302 Found对于Google与其他搜索引擎来说还有SEO的隐喻
  • 301 Moved Permanently有缓存的含义,而429 Too Many Requests则没有缓存的含义,诸如此类
  • 客户端库可以通过一段时间的延迟后重试请求来处理429 Too Many Requests
  • 客户端库可以采取类似的方式处理503 Service Unavilable

2. 很多状态码所表示的情况可以通过特殊的响应进行处理。

  • 返回404而非405 Method Not Allowed的APIs有时会让我抓狂,“我是输错了URL还是使用了错误的HTTP方法呢”?
  • 正确区分502 Bad Gateway与500 Internal Server Error会让你省下不少的调试时间。

3. 不管信不信,目前很多流行的APIs建立了一些约定,比如说返回201 Created、429 Too Many Requests,或是503 Service Unavilable。如果遵循这些约定,那么用户在使用你的网站/API时就会更轻松,遇到问题时也更容易解决。

如果你在使用HTTP状态码时遇到了问题,还可以参考如下资源:

各位读者,相信你们中的很多人都曾经或是正在设计API,那么在这个过程中对于状态码你做过哪些思考呢?有哪些见解呢?欢迎分享出来与InfoQ的其他读者一同讨论。

时间: 2024-11-05 06:14:27

如何选择正确的HTTP状态码的相关文章

layui,返回的数据不符合规范,正确的成功状态码 (code) 应为:0

在使用layui的数据表格绑定数据的时候,出现的一些问题,  "返回的数据不符合规范,正确的成功状态码 (code) 应为:0" 之后在网上也查找的了许多的资料,也去看了官网的文档, 就是说绑定数据有官网指定的格式 code是返回的状态 data是数据 这两个是必须有的 ,这个数据格式的名称是可以更改的 数据必须是这样的格式 但是当我在后台传递了官方给出的格式并传到前台 发现和官方给出的数据格式是一致的 但是还是同样的错误 ,这就很让别人火大啊 上面是官网给出的数据格式 之后请教了一个

HTTP 协议 -- 状态码

HTTP 协议状态码(Http Status Code) 使用ASP.NET/PHP/JSP 或者javascript都会用到http的不同状态,一些常见的状态码为: 200 – 服务器成功返回网页 404 – 请求的网页不存在 503 – 服务不可用 1xx(临时响应) 表示临时响应并需要请求者继续执行操作的状态代码. 代码   说明 100   (继续) 请求者应当继续提出请求. 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分. 101   (切换协议) 请求者已要求服务器切换协

喵星人教你记 HTTP 状态码

记忆HTTP状态码是有一些困难的,因为状态码很多且很难记忆.GirlieMac,也就是Tomomi Imura利用她巧妙的构思,PS了一系列的HTTP状态信息.在你看过这些图片之后,你绝对可以记住一些 HTTP 状态码,因为我就只是在这里才学会了这些状态码. 以下列出这些状态码以及它们最基本的含义 100 继续 表示服务器已经接收到了请求头,并且客户端应该继续发送请求体. 101 切换协议 表示请求方已经要求服务器切换协议,并且服务器已经接受并会进行处理. 200 正常 HTTP 请求成功的标准

常见的HTTP状态码深入理解

状态码的职责是当客户端向服务器端发送请求时,描述返回请求结果.借助状态码,用户可以知道服务器端是正常处理了请求,还是出现了什么错误. RFC2616定义的状态码,由3位数字和原因短信组成. 数字中的第一位指定了响应类别,后两位无分类.响应类别有以下5种: Type Reason-phrase Note 1XX Informational 信息性状态码,表示接受的请求正在处理 2XX Success 成功状态码,表示请求正常处理完毕 3XX Redirection 重定向状态码,表示需要客户端需要

选择一个 HTTP 状态码不再是一件难事 – Racksburg

原文链接:http://racksburg.com/choosing-an-http-status-code/ 打开双语对照阅读 有什么能比 HTTP 响应状态码更简单呢?页面渲染了吗?好极了,返回 200.页面不存在?那么是 404.想要跳转到另一个页面?302 或者可能是 301. 我喜欢把 HTTP 状态码想象成无线电波传输的 10 码1.“呼叫,呼叫,我是 White Chocolate Thunder,发现 200 OK.” —— Aaron Patterson (@tenderlov

选择一个 HTTP 状态码不再是一件难事 – Racksburg《转载》

本文转载自:众成翻译 译者:十年踪迹 链接:http://www.zcfy.cc/article/904 原文:http://racksburg.com/choosing-an-http-status-code/ 有什么能比 HTTP 响应状态码更简单呢?页面渲染了吗?好极了,返回 200.页面不存在?那么是 404.想要跳转到另一个页面?302 或者可能是 301. 我喜欢把 HTTP 状态码想象成无线电波传输的 10 码<sup>1</sup>.“呼叫,呼叫,我是 White

常见HTTP状态码

一些常见HTTP状态码为:200 – 服务器成功返回网页404 – 请求的网页不存在503 – 服务不可用 常见HTTP状态码大全 1xx(临时响应)表示临时响应并需要请求者继续执行操作的状态代码. 代码 说明http状态码 100 (继续) 请求者应当继续提出请求. 服务器返回此代码表示已收到请求的第一部分,正在等待其余部分.http状态码 101 (切换协议) 请求者已要求服务器切换协议,服务器已确认并准备切换. 2xx (成功)表示成功处理了请求的状态代码.代码 说明http状态码 200

http协议的状态码 200、301、304、404、502 HTTP状态码解释

在网站建设的实际应用中,容易出现很多小小的失误,就像mysql当初优化不到位,影响整体网站的浏览效果一样,其实,网站的常规http状态码的表现也是一样,Google无法验证网站几种解决办法,提及到由于404状态页面设置不正常,导致了google管理员工具无法验证的情况,当然,影响的不仅仅是这一方面,影响的更是网站的整体浏览效果.因此,比较清楚详细的了解http状态码的具体含义,对于一个网站站长来说,这是很有必要俱备的网站制作基础条件. 如果某项请求发送到您的服务器要求显示您网站上的某个网页(例如

HTTP请求响应报文&amp;&amp;相关状态码&amp;&amp;GET_POST请求方法 总结

HTTP请求报文: 一个HTTP请求报文由四个部分组成:请求行.请求头部.空行.请求数据 1.请求行   请求行由请求方法字段.URL字段和HTTP协议版本字段3个字段组成,它们用空格分隔.比如 GET /data/info.html HTTP/1.1 方法字段就是HTTP使用的请求方法,比如常见的GET/POST 其中HTTP协议版本有两种:HTTP1.0/HTTP1.1 可以这样区别: HTTP1.0对于每个连接都的建立一次连接一次只能传送一个请求和响应,请求就会关闭,HTTP1.0没有Ho