空列表HTTP 200还是404？

Question

我知道这是一个相当普遍的问题，但是我还没有找到让我满意的答案。

我已经使用django rest框架一段时间了，但除了给出的例子之外，这基本上是无关紧要的。其默认行为是在访问具有空项目列表的路由时返回具有空列表资源的 HTTP 200。例如：如果我们有一个路由，如/articles/来访问文章列表，但它不包含任何项目，我们将得到类似于以下json的响应：

{"count":0, "next":null, "previous":null, "items": []}

这很好。我们在/articles/找到了我们要找的资源，只是碰巧其中没有项目。

如果我们访问路由/文章/？ page=1，我们会得到完全相同的响应。

目前为止，一切都好。现在我们尝试访问 /articles/？page=2，响应代码发生了变化。现在获取404，就好像找不到资源一样，并显示一条错误消息，指出该页面不包含任何结果。这与 ？page=1 的情况相同...

我对这种行为完全没问题，但今天我开始质疑这种设计。？page=1 的情况与 ？page=2 有何不同？更重要的是，在发出HEAD请求时，您如何判断请求是否“有效”？在包含任何结果的意义上有效。

这在过滤列表检查某个字段的可用性（例如，向 /users/？username=ted 发出 HEAD 请求）等情况下可能很有用。

• 200的答复显然意味着该请求已被理解，并找到了物品
• 404表示请求已被理解，但在该位置/URI处未找到任何项（AFAIK查询参数也是URI的一部分）
• 如果无法理解请求，则对于语法错误将返回400，对于语义错误将返回422

这是一个好的设计吗？为什么大多数人似乎不同意它，它有什么缺点？

Answer 1

这实际上归结为“nullvs空集合”参数。null的情况也是HTTP 404的情况，空集合的情况也是HTTP 200的情况。

如果我们有一个像/articles/这样的路径来访问文章列表，但是它不包含任何条目

假设这是一个全球文章列表，即:

< code > http://my website/articles

那么这个响应永远不能为空，因此永远不应该是404。文章的全局列表总是存在的，因此集合总是不为空，不管它是否包含元素。

这里的一个简单示例是考虑SQL查询。如果一个表存在，即使它是空的，查询也会返回一个结果（无论它是否为空），因此使用200。如果表本身不存在，则会得到一个查询错误，因此使用404。

但是如果文章包含在另一个资源中，例如它们的作者：

< code > http://my website/authors/John doe/articles

现在我们到了< code>null(以及404)可能存在的部分。

• 如果 johndoe 存在并且有文章，则返回一个非空列表
• 如果 johndoe 存在并且没有文章，则返回空列表，HTTP 状态为 200
• 如果 johndoe 不存在，则返回 null 和 HTTP 状态 404

这将正确的响应传达给用户。200显示数据已正确获取，而404显示请求的资源根本不存在。

请注意，当提到特定文章而不是列表时，这略有不同。当返回特定资源(或不返回)而不是列表时，404是“无项目”响应的唯一正确HTTP状态。

< code > http://my website/article/1

在这里，您要么返回文章，要么返回 null。

< code > http://my website/authors/John doe/articles/1

在这里，当作者 johndoe 或文章 1 不存在时，您将返回 404。

Answer 2

这是出于UI考虑(page1必须存在！)，尽管如此，它决定了响应代码。

Answer 3

我会选择< code>200，因为资源是< code >文章。当在< code>users中查询< code>ted时，情况也是如此，< code>users是资源，只要它在那里，从我的观点来看，< code>200就可以了。如果您< code > GET < code > users/ted 一个< code>404将与一个< code>410(消失)一样好，如果一个叫ted的用户过去在那里(可能更适用于文章而不是用户)。