RESTful API 是现在 Web 开发中最常见的 API 设计风格，其优点在于简单易懂、易于扩展、灵活可靠。但在实际应用中，RESTful API 往往会遇到一些奇怪的现象，本文将结合实际案例，为大家介绍其中一些常见问题以及解决方案。
奇怪现象：404 Not Found
404 Not Found 是 Web 开发中最常见的错误，表示无法找到请求的资源。但有时候它会在显然有资源的情况下出现，比如下面这个例子：
GET /api/product/123
在这个例子中，我们请求的是 ID 为 123 的产品，但服务器返回了一个 404 Not Found 错误，说明该资源不存在。但实际上，产品列表中是有这个产品的，而且其他产品的请求也正常，这是怎么回事？
解决方案：检查资源路径
造成这种情况的原因可能有很多，其中最常见的是请求的资源路径错误。在上述例子中，我们可能会有意或无意地写错了 URL，例如：
// 错误的 URL，导致请求的资源不存在 GET /api/products/123
这个 URL 中的 “products” 少写成了 “product”，从而导致服务器无法找到请求的资源。因此，当我们遇到 404 Not Found 错误时，首先应该检查请求的资源路径是否正确。此外，在使用 RESTful API 时，可以为每个资源路径设立统一的标准，利用 URL 规范减少错误的发生。
奇怪现象：405 Method Not Allowed
405 Method Not Allowed 表示请求使用的 HTTP 方法不被服务器支持。例如：
PUT /api/product/123
在这个例子中，我们使用的是 PUT 方法，但服务器返回了一个 405 Method Not Allowed 错误。这是什么原因呢？
解决方案：检查请求的 HTTP 方法
导致 405 Method Not Allowed 错误的原因很简单，就是请求使用的 HTTP 方法不被服务器所支持。在上述例子中，如果服务器只支持 GET 方法，那么我们使用 PUT 方法时就会出错。因此，在使用 RESTful API 时，除了要检查资源路径以外，还要仔细核对请求所使用的 HTTP 方法。
奇怪现象：500 Internal Server Error
500 Internal Server Error 表示服务器内部出错，此时我们无法确定具体出错的原因，只能通过服务器日志或其他途径进行排查。但有时候，这个错误也会产生一些奇怪的现象，例如：
POST /api/products
Content-Type: application/json
{
"name": "Product A",
"price": -123
}在上述例子中，我们向服务器发送了一个 POST 请求，请求体中包含一个价格为负数的产品信息。但服务器返回了一个 500 Internal Server Error 错误，我们无法确定具体出错的原因。
解决方案：检查数据的合法性
产生 500 Internal Server Error 错误的原因可能有很多，但其中最常见的是数据的合法性问题。在上述例子中，我们向服务器传递了一个价格为负数的产品信息，但在业务逻辑中，价格不可能为负数，从而导致服务器内部出错。因此，在使用 RESTful API 时，我们需要检查请求所包含的数据是否合法，在数据校验出错的情况下，应该返回一个明确的错误提示，而不是简单地返回一个 500 Internal Server Error 错误。
奇怪现象：200 OK
200 OK 表示服务器正常处理了请求，并返回了响应结果。但有时候这个状态码也会出现奇怪的现象，例如：
DELETE /api/products // 响应结果为空
在上述例子中，我们向服务器发送了一个 DELETE 请求，但服务器返回了一个 200 OK 状态码，并且没有任何响应结果。这是怎么回事呢？
解决方案：检查响应结果的符合性
在使用 RESTful API 时，我们不仅需要检查请求的合法性，还要检查响应结果的符合性。在上述例子中，服务器返回了一个 200 OK 状态码，说明请求正常处理，但响应结果为空，这并不符合业务逻辑要求。因此，我们需要检查响应结果是否符合预期，如果不符，应该返回一个明确的错误提示。
总结
以上就是 RESTful API 使用中遇到的一些奇怪现象以及解决方案。在使用 RESTful API 的过程中，我们需要对请求和响应进行全面的检查和测试，避免因小失大。同时，RESTful API 的设计也需要遵循统一的标准，规范请求路径和 HTTP 方法的使用，从而减少错误的产生。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64e5e61bf6b2d6eab3160ff8