查询无交易记录的银行账户应返回HTTP 200还是404状态码？

核心判断依据 #

HTTP状态码的语义是针对请求对应的资源本身是否存在、请求是否被正常处理定义的，和业务层面有没有查到具体数据没有直接关系：

• 404状态码的适用场景是：请求的目标资源本身不存在。比如你查询未在accounts_data中登记的账户、输错了API访问路径，这时候服务器根本找不到你要访问的目标资源，才应该返回404。
• 200状态码的适用场景是：请求被服务器正常接收、处理完成，返回了对应的结果。

你当前的场景里，Jack的账户真实存在，查询Jack交易历史的接口资源是合法可访问的，只是Jack还没有产生过交易，返回的结果是空集合——这本质是「资源存在，但当前内容为空」的正常查询结果，完全符合200的语义，就像刚注册的新电商账号打开订单页，页面正常加载只是显示「暂无订单」，不可能弹出404页面错误。

推荐响应格式 #

返回200状态码的前提下，响应体可以按常规业务结构返回，示例：

{
  "success": true,
  "message": "您查询的账户暂无对应交易历史",
  "data": []
}

易混淆场景区分 #

• 如果你查询的是根本不存在的账户（比如accounts_data里没有Tom这个用户），此时请求的「Tom的交易历史」资源从根上不存在，才应该返回404。
• 不要把业务层的「无查询结果」和协议层的「资源不存在」混为一谈，业务层面的结果状态应该放在响应体的自定义字段里标识，不要滥用HTTP状态码承载业务判断逻辑，否则会导致前端、网关层的状态处理逻辑混乱。

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