POST创建用户传入不存在的company_id，应返回何种HTTP状态码？

这是个很常见的REST API设计问题，咱们逐个拆解选项，找到最贴合的状态码：

• 400 Bad Request：这个状态码针对的是请求格式或参数本身非法的情况，比如company_id传了字符串“abc”而非数字，或者参数缺失。但你的场景里company_id格式合法，只是对应的公司不存在，所以400并不合适。
• 404 Not Found：404通常表示请求的目标资源不存在，比如你GET一个不存在的用户ID时用它。但这里你是POST创建新用户，目标资源（新用户）还没生成，不存在的是关联的公司——直接返回404的话，客户端很可能误解成“创建用户的接口不存在”，语义上不够精准，所以不推荐。
• 409 Conflict：冲突状态码用于请求会导致资源状态冲突的场景，比如重复创建邮箱唯一的用户，或者修改资源时版本不匹配。关联资源不存在不属于“冲突”范畴，用户更换company_id也不是解决冲突，而是修正语义错误，所以409不合适。
• 500 Internal Server Error：这是服务器内部故障的专用码，比如数据库连接失败、代码逻辑bug。你的场景是业务逻辑校验不通过，完全是客户端请求的语义问题，和服务器自身故障无关，绝对不能用500。
• 422 Unprocessable Entity：这个才是最匹配的！它的定义是：服务器理解请求的内容类型，请求语法也正确，但无法处理请求中的语义错误。你的情况正好符合：请求格式没问题，参数格式合法，但语义上引用了一个不存在的company_id，服务器没法完成创建用户的操作，返回422再合适不过。

另外，返回422的时候，建议在响应体里明确给出错误细节，比如：

{"error": "Company with id 34 does not exist"}

这样客户端能立刻明白问题出在哪，方便快速修正请求。

内容的提问来源于stack exchange，提问作者Talita