RESTful API请求不存在的分类文章列表应返回200还是404？

这两种方案都有各自的合理性，具体选择取决于你的API设计目标和客户端的需求：

返回404 Not Found（更符合REST规范的选择） #

• 路由中的news是一个明确的资源标识符（分类资源），当该分类本身不存在时，相当于请求了一个不存在的资源，完全符合404状态码的语义——「请求的资源未被找到」。
• 能清晰区分「分类存在但无文章」和「分类本身不存在」两种不同场景，让客户端可以针对性处理：比如前者提示「该分类暂无文章」，后者提示「分类不存在，请检查分类名称」。
• 响应体可以补充简单的错误说明，比如：

  {
    "error": "指定的分类不存在"
  }
  

返回200 OK带空数据（简化客户端逻辑的选择） #

• 可以让客户端统一处理「无内容」的情况，不用额外编写404错误的分支逻辑，降低客户端的复杂度。
• 适合你的API更聚焦于「获取分类下文章」这个动作，而不需要客户端感知分类是否存在的场景。

建议 #

如果你的API需要为客户端提供明确的状态区分，优先选择返回404；如果追求客户端逻辑简洁，且不需要区分两种无内容场景，返回200带空数据也可行，但一定要在API文档中明确说明这种行为，避免客户端误解。

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