You need to enable JavaScript to run this app. REST接口无效路径、查询参数对应的HTTP错误码(400/404)选择规范咨询
优惠活动
大模型
产品
解决方案
定价
更多

REST接口无效路径、查询参数对应的HTTP错误码(400/404)选择规范咨询

REST非法参数的HTTP状态码判定(400 vs 404)

核心判定边界(HTTP标准通用共识)

  • 400 Bad Request:请求已被服务器识别(即路由匹配成功),但请求内容(路径参数、查询参数、请求体等)不符合校验规则/格式要求,服务器无法处理。
  • 404 Not Found:服务器未找到与请求URI匹配的路由/资源,即该URI对应的服务逻辑根本不存在。

场景1:路径参数countryCode非法(如传入CN而非US/UK)

这一争议的本质是对服务端路由实现方式的假设不同:

两种实现对应的状态码

  • 若采用静态枚举路由:仅注册/rest/v1/qvc/US/users、/rest/v1/qvc/UK/users两个硬编码端点,传入其他国家码时无匹配路由,此时返回404 Not Found符合规范。
  • 若采用通配符路由:仅注册/rest/v1/qvc/{countryCode}/users一个路由,再通过参数校验器(如JSR-380、Spring Validation)限制取值为US/UK,此时请求已匹配路由,仅参数取值违规,返回400 Bad Request。

行业通用最优实践

当前REST生态中,通配符路由+参数校验是绝对主流:

  • 静态枚举路由维护成本极高(新增国家码需手动修改路由配置),且错误提示不友好(仅能告知“资源不存在”,无法明确是国家码取值错误)。
  • 通配符模式下,返回400 Bad Request时可附带结构化错误详情,明确告知客户端违规原因,大幅降低调试成本。

因此,该场景下的通用正确实现为返回400 Bad Request。


场景2:查询参数numberOfusers非法(如传入-9)

查询参数不属于路由的组成部分(路由仅匹配/rest/v1/qvc/{countryCode}/users的路径结构),无论查询参数取值是否合规,请求已匹配到对应路由。此时参数取值不符合“非负整数”的校验规则,无任何争议地返回400 Bad Request。

注:返回400时需附带结构化错误信息,明确指出违规参数及原因,例如:

{
  "errorCode": "INVALID_PARAMETER",
  "message": "numberOfusers must be a non-negative integer; received -9"
}

内容的提问来源于stack exchange,提问作者Jacob Kurian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 21:36:04