客户端错误请求400 vs 422

Question

我已经阅读了很多关于正确的http状态代码的帖子和文章，以便返回客户端请求错误。其他人建议使用400，因为它已在RFC 7231中重新定义，但我不确定给出的示例是否涵盖了我脑海中的所有客户端错误，因为这些示例是语法的。

400（错误请求）状态代码指示服务器由于被认为是客户端错误（例如，格式错误的请求语法，无效请求）而不能或不会处理该请求 消息框架或欺骗性请求路由）。

我确实在rfc 7231的附录B中找到了这个陈述：

400（错误请求）状态代码已放宽，因此不是 限于语法错误。 （第6.5.1节）

这是否意味着我可以将任何类型的客户端错误视为错误请求？将400用于客户端请求并在消息中指定更具体的错误会更好吗？

另一方面，其他人说最好使用422（不可处理的实体）。虽然这更侧重于语义，但它仅在RFC 4918中列出，这是http / 1.1的webDAV扩展

422（不可处理实体）状态代码表示服务器 了解请求实体的内容类型（因此a 415（不支持的媒体类型）状态代码不合适），和 请求实体的语法是正确的（因此是400（错误请求） 状态代码不合适）但无法处理包含的指令。例如，如果是XML，则可能会出现此错误情况 请求正文包含格式正确（即语法正确），但是 语义错误的XML指令。

我可以使用此webDAV扩展代码来处理我的http请求吗？在422的情况下，我可以使用它，即使它不在核心http代码中。

我应该使用400或422来解决客户端错误吗？

以下是我想到的可能的客户端错误：

1.) Invalid parameter. The client provided parameters but are found invalid. Example: I said that the userId is 1, but when I checked there's no userId of 1. Another example of invalid parameter is wrong data type.
2.) Missing required parameters
3.) Let's say I need to hash a value based on given params and it failed 
4.) Blocked content is being used. Like, i want to apply for membership and i passed the userId of 1. However, userId of one is blocked / deactivated
5.) When I try to delete an entry but the entry is still being used in another table. 
6.) Let's say i require a signature in my payload and the signature does not match when recalculated in the backend
7.) Let's say I have a value that counts a specific attribute like "shares" and it has reached the maximum value like 10.
etc...

任何信息性的回应将受到高度赞赏。非常感谢，伙计们！

更新：我检查了谷歌api错误，他们没有使用422.另一方面，Twitter使用422.我比以往更困惑>。<虽然有一部分我认为400是更好的选择，因为它包括在RFC doc和422中没有。我可能错了。

Answer 1

我可以使用此WebDAV扩展代码来处理我的HTTP请求吗？在422的情况下，我可以使用它，即使它不在核心HTTP代码中。

HTTP是一个可扩展的协议，422是registered in IANA，这使它成为标准的状态代码。所以没有什么能阻止你在你的应用程序中使用422。

我应该使用400或422来解决我的客户端错误吗？

这取决于，但你可以使用两者。通常，使用400指示有效内容中的语法错误或URL中的无效参数。并使用422来指示有效负载中的语义问题。

例如，请参阅approach使用的GitHub v3 API：

Client errors

接收请求主体的API调用有三种可能的客户端错误类型：

1. 发送无效的JSON将导致400错误请求响应。

   HTTP/1.1 400 Bad Request
   Content-Length: 35
   
   {"message":"Problems parsing JSON"}

2. 发送错误类型的JSON值将导致400错误请求响应。

   HTTP/1.1 400 Bad Request
   Content-Length: 40
   
   {"message":"Body should be a JSON object"}

3. 发送无效字段将导致422不可处理实体响应。

   HTTP/1.1 422 Unprocessable Entity
   Content-Length: 149
   
   {
     "message": "Validation Failed",
     "errors": [
       {
         "resource": "Issue",
         "field": "title",
         "code": "missing_field"
       }
     ]
   }

---

选择最合适的4xx状态代码

Michael Kropat汇总了set of decision charts，有助于确定每种情况的最佳状态代码。有关4xx状态代码，请参阅以下内容：

HTTP API的问题详细信息

HTTP状态代码有时不足以传达有关错误的足够信息。 RFC 7807定义了简单的JSON和XML文档格式，以通知客户端HTTP API中的问题。这是报告API错误的一个很好的起点。

它还定义了application/problem+json和application/problem+xml媒体类型。