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
相关产品推荐
相关产品推荐

