API路径参数是否需验证？字符串ID应返回400还是404？

是否需要验证id的数据类型？ #

必须验证。你的接口明确约定id为Integer类型，客户端传入非整数参数属于违反接口规范的无效请求。提前做类型验证，既能避免后续数据库查询等逻辑抛出不必要的异常，也能直接给客户端明确的错误反馈，同时减少无效的服务端资源消耗。

传入/api/examples/abc这类字符串id时返回400还是404？ #

应该返回400 Bad Request，原因如下：

• 404的核心语义是「请求的资源不存在」，前提是请求参数的格式符合接口要求，只是对应id的资源在数据库中找不到。比如传入/api/examples/999但数据库无此记录，返回404才合理。
• 而abc不是合法的Integer类型id，属于请求参数格式错误，完全不符合接口约定的参数规范。这种情况下用400更贴合HTTP状态码的定义——客户端发送的请求存在参数格式问题，服务器无法正常处理该请求。

返回400时建议在响应体中补充明确的错误信息，比如{"error": "id必须为整数类型"}，帮助客户端快速定位问题。

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