API端点无效ID处理方案咨询：含ID不存在与类型错误场景

咱们直接把这两个场景拆解清楚，绝对不要用500——那是给服务器自己出故障留的，和客户端请求错误完全不沾边：

场景a：传入的id在数据库中不存在（比如id=100无对应实体） #

返回 404 Not Found 是行业标准做法。
原因很简单：客户端请求的是一个特定ID的people资源，而这个资源在服务器的数据库里根本不存在。404的语义就是「你要找的东西我这儿没有」，完全匹配这个场景。如果返回500就离谱了——这不是服务器内部出错，是客户端找了个不存在的资源，锅在客户端的请求目标上。

场景b：传入的id类型错误（比如字符串"oops"） #

返回 400 Bad Request 才是正确的。
因为你的API明确定义了id是整数类型，客户端传了个字符串，属于请求格式不符合约定。400的语义就是「你的请求有问题，格式不对，请按要求重新发」，完美对应这种参数类型不匹配的情况。同样，这也不是服务器的错，没必要返回500（那会让客户端误以为服务器炸了，而不是自己传错了参数）。

额外提醒：为什么绝对不能用500？ #

HTTP状态码的分类是有明确语义的：

• 4xx系列：客户端错误——问题出在客户端的请求上，客户端可以修正请求后重试。
• 5xx系列：服务器错误——问题出在服务器自身，客户端没法通过修改请求解决。

你说的这两个场景都是客户端的请求不符合API约定，完全属于4xx的范畴，用500会混淆错误责任，还会给客户端排查问题带来误导，绝对不可接受。

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