REST API路径参数缺失/值错误时的HTTP状态码咨询

作为常年跟REST API设计打交道的开发者，我来帮你理清这两个问题的最佳实践：

通用场景的状态码建议 #

• 路径参数缺失：如果因为参数缺失导致请求的URI对应的资源根本不存在（比如你提到的/search/），这时候返回404 Not Found是最标准的选择。从REST的资源定位逻辑来看，这个URI并没有映射到任何已知的服务资源，客户端能直观理解是访问了一个不存在的地址。
• 路径参数值错误：当参数存在但值不在允许的范围内（比如传入"D"而非规定的"A/B/C"），推荐返回400 Bad Request。这个状态码专门用于表示客户端请求存在无效参数、语法错误等问题，服务器可以识别请求但无法处理。当然也有部分团队会用422 Unprocessable Entity，但400是行业内更通用、兼容性更好的选择，尤其适合枚举值不匹配的场景。

针对/search/{option}接口的具体处理 #

回到你给出的这个接口场景：

• 当参数缺失，请求落到/search/时：直接返回404 Not Found，因为这个端点本身就不存在，符合资源未找到的定义。
• 当传入错误值（如"D"）时：返回400 Bad Request，同时建议在响应体里补充明确的错误说明，比如：

  {"error": "Invalid option. Allowed values are: A, B, C"}
  

  这样客户端能快速定位问题所在，调试效率更高。

需要注意的核心区别是：404针对的是资源不存在，而400针对的是请求本身无效——服务器能接收到请求，但因为参数错误无法正常处理。

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