http协议的返回状态码规范问题

Question

假设，客户端发送了一个请求到服务器，服务器验证数据后，发觉不符合，需要返回一个错误。

我理解是，客户端由于请求过程是正确的，所以即使数据格式不符合服务端的要求，服务端也应该返回200状态码，然后在正文里带回错误信息，或一些json格式的报文，在报文里再附上真正的状态码。

但是看了一些别人的接口，有人是直接返回510状态码。

请问，各位有何高见？哪种才是规范？

Answer 1

很多网上那些接口，大多是不符合规范的，说白了就是一群连 HTTP 协议都不懂的人写的 HTTP 服务，毫无参考价值。所以不要纠结那些。为什么 PHP 招黑和这个原因类似，很感激你愿意深究这个问题，为你这种精神必须点赞。其实我建议你购买此书：《HTTP 权威指南》，很适合你这种有上进心的人。对于这个问题，实际上你的理解有偏差。请求过程正确不意味着响应就应当是 200。因为能够获得响应，就已经说明请求 过程 是没有任何问题的，若是请求过程不正确，不是 DNS 异常就是连接超时等等，你连响应码都看不到的。所以响应码是用来标识 HTTP 服务器收到请求后，对此响应给出的结果。为此，主要 划分了 2xx、3xx、4xx、5xx 这几种，2 打头的肯定是成功（不仅仅是 200 哦），3 开头的往往是无异常，但可能资源不是直接从你这个请求获取的，比如 302 重定向，304 缓存未过期等等。重点来了，4 打头的，往往是请求存在异常，比如你所谓的提交的数据格式不正确 400 或 422，请求需要授权的 401，因为某种原因（权限不足或者黑名单）导致的拒绝用 403，请求的数据不存在或者该数据不想被当前请求获取用 404（很熟悉吧），请求方法被拒绝用 405，比如修改数据应该用 PUT 请求、新增数据用 POST，获取数据用 GET，删除数据用 DELETE 请求等等（还有常见的 OPTIONS 和 HEAD 请求哦），当然，4 开头的响应码最多，可以在百科（不论啥百科）都有 HTTP 状态码的详细文章。5 开头的主要是服务器错误，不是因为请求的错误引起的异常都是用 5 开头的状态码，比如 500 服务器异常、503 服务器无法提供服务。HTTP 状态码是在 RFC 一系列标准文件中定义的，因此不能够完全适应所有的接口提示细节，但已经能够完全涵盖大部分响应的语义。对于细节提示，接口响应中往往会单独在设置一个状态响应码，用来弥补 HTTP 状态码对于细节问题的表现力不足的情况。比如都是请求格式错误，但是缺少某个参数和参数给多了，都是 400，如果想要让客户端清楚地知道发生了什么，你还需要在接口中额外定义一些东西，辅助这类情况。

Answer 2

规范各种各样各有各的理，你说的两种状态码一种是以http请求为主参照来分析状态码，另一种是以自己接口为主参照来分析状态码。两种都有自己的理由，看使用场景吧规范吗，还是跟着公司走~，个人比较喜欢用http状态码返回错误并带上错误信息。

Answer 3

这个得看你们项目之中是怎么规范的的！你可以按照http的方式来，也可以自己去设置！比如说，你接受到了这个错误状态码，然后自己设置一个新的状态码，然后顺带返回一些信息提示就行了！

Answer 4

看需求而定,项目整体规范为准,如果你个人为项目主导,也可以你为准

Answer 5

个人觉得用http状态码才正确。510 不了解，说个我经常写的状态码。http status 400 和 403。前者代表请求无法解析，一般多是参数有问题，而且多数时候这个错误是不需要写代码判断，服务器程序会自动判断并返回这个状态。比如 我参数只允许传1-10之间的数，如果用户瞎传我就会返回这个状态码。后者的含义是用户没有权限访问，这种错误除了部分在配置里设置的禁止访问的路径外，很多时候需要写代码进行权限判断。比如我的后台只允许 某些特定ip和带有特定请求头的机器访问，其他机器全部返回这个状态码。如果改用200 + json返回 状态码，那http这些标准的状态码的含义就基本没用。那设计者早就把他简化的只剩下200和404了。甚至404也可以用 json 状态码，只用200表示连通没连通即可。那状态码有什么好处呢？现代的浏览器和搜索引擎爬虫都会识别 和部分处理http状态码举个例子：4xx 的状态码表示当前这个url不对，没有再次发送请求的意义。如果你某个页面返回的是 http 200 + json 400 表示 他参数有问题。搜索引擎 不会去解析你的自定义状态码，自然会将本条数据错误的收录。某些用户通过搜索引擎会跳转到这个参数不正确的页。浏览器 同样不会去解析你的自定义状态码， 浏览器会自动记录你的访问记录，而浏览器接到400、403和404之类的状态码是不会保存浏览记录（chrome是这样，其他的好像也差不多吧）。而你返回200后，用户输入网址时有很高的概率会点击浏览器的提示记录，结果又一次访问了错误的连接。