rest - 在 RESTful API 中返回 HTTP 500 好吗？

Question

当我编写 RESTful API 服务器时，通常我不会在我的代码中返回 HTTP 500。 在我看来，HTTP 500 错误意味着:

您无法控制的某些情况/异常。您没有意识到可能会发生错误

如果您意识到可能会发生某些错误，您总是可以找到一些其他的 HTTP CODE 来表示它。例如 503。

所以我不想手动返回 HTTP 500。在那种情况下，如果发生 500，那么我知道这是一些未处理的异常

这是一个好的做法吗？

Answer 1

Is it good to return HTTP 500 in a RESTful API?

没关系。 500 Internal Server Error具有广泛适用的语义。

我认为关键思想是:当问题出在服务器上时，客户端(或中间组件)无法做很多事情来改善这种情况。

当然，当错误出现在请求中时，您不应该使用 500 状态代码。区分 4xx 和 5xx 比区分 500 和 50x 重要得多。

对于服务器错误，我希望您选择 500，除非其他一些代码明显更合适(例如:503 用于 Retry-After 语义可能证明有用的临时情况)。