你有没有觉得每次你试图取得进展时，计算机系统都在竖起砖墙？如果您最近一直在使用 API，听起来您可能正在处理一些常见错误。

立即下载：Java & JavaScript 简介

这些错误消息可能会让任何人挠头，但不要害怕！我们在这里帮助分解一些更常见的错误以及如何最好地解决它们，这样您的一天就不会变得非常头疼。

这篇博文将列出经常弹出的 11 个 API 错误以及如何对其进行故障排除。让我们开始吧！

HTTP 状态代码概述

在我们深入研究特定错误之前，以下是 HTTP 状态代码的快速概述。HTTP 状态代码是 API 错误的主要指示器。它们是服务器让您知道它对您的请求的看法的方式。

如果状态代码介于 200 和 299（含）之间，则表示 API 调用成功。但是，如果出现错误，您将获得 4xx 或 5xx 状态代码。

4xx 状态代码 – 客户端错误：客户端（您，API 用户）发送了服务器无法正确处理的请求。

5xx 状态代码 – 服务器错误：服务器遇到意外情况，阻止它完成请求。

在许多情况下，可以按照提供的故障排除提示解决这些错误。

11 个常见的 API 错误及其故障排除

现在我们已经掌握了基础知识，让我们看一些更常见的 API 错误。

1. 400错误请求错误

此错误是最常见的 API 错误之一，当服务器无法解析请求本身时会发生此错误。这可能是由不正确的 URL、API 请求的组成方式错误，甚至是应用程序本身的问题引起的。

若要解决此问题，请首先检查 URL 并确保其外观正确。然后，检查 API 请求的语法，确保所有内容的格式正确。如果这不能解决问题，您应该返回应用程序并搜索任何明显的错误。

2. 401 未经授权的错误

当服务器无法授权用户的凭据时，会发生此 API 错误。这可能是由于用户名或密码不正确甚至缺少权限访问权限造成的。

要排查此 API 错误，请首先确认您的用户名和密码正确无误。如果它们正确并且您仍然收到错误，则可能是权限问题;如果是这样，请联系您的 API 提供商以获取进一步的帮助。

3. 403 禁止错误

当服务器由于 API 提供程序设置的授权问题或其他限制而拒绝满足来自客户端的请求时，会发生此 API 错误。

要排查此 API 错误，请确保您具有在相关 API 终端节点上发出请求的足够权限。然后，检查 API 文档，确保随请求一起发送有效的数据参数。最后，验证是否存在可能阻止访问相关 API 终结点的外部限制。

4. 404 未找到错误

当服务器无法从 API 提供程序找到请求的资源时，会发生此 API 错误。这可能是由于 URL 不正确或 API 请求的组成方式有问题造成的。

若要排查此 API 错误，请首先验证 URL 是否正确。检查 API 文档以确保在请求中使用正确的数据参数也很重要。最后，如果所有其他方法都失败了，请联系您的 API 提供商以获取进一步的帮助。

5. 408 请求超时错误

当服务器在指定的时间内未收到来自客户端的响应并且连接已终止时，会发生此 API 错误。

要排查此 API 错误，请仔细检查 URI 是否正确、检查互联网连接、重新加载页面或检查 Web 服务器的超时设置。

6. 500 内部服务器错误

当服务器遇到阻止其完成 API 请求的意外情况时，会发生此 API 错误。这可能是由 API 提供程序的内部系统出现问题引起的，或者 API 请求的组成方式可能存在问题。

要排查此 API 错误，请查看 API 文档，以确保随请求一起发送有效的数据参数。然后，请联系您的 API 提供商，以获取进一步的帮助，以解决其内部系统中的任何潜在问题。

7. 502 错误的网关错误

当服务器充当代理并从另一个上游服务器收到无效响应时，会发生此错误。这可能是由于域名未解析为正确的 IP、无法访问服务器或火线阻止通信造成的。

要排查此 API 错误，请检查您的域名，验证您的服务器是否可访问，或检查您的防火墙日志。

8. 504网关超时错误

当服务器充当代理并且在指定时间内未收到上游另一台服务器的响应时，会发生此 API 错误。这可能是由互联网连接问题或 API 请求的组成方式错误引起的。

要排查此 API 错误，请首先验证您的互联网连接是否正常运行，然后查看 API 文档以确保您在请求中发送了有效的数据参数。

9. 505 HTTP 版本不支持错误

当服务器不支持客户端请求的 HTTP 协议版本时，会发生此 API 错误。

要排查此 API 错误，请验证您使用的是受支持的 HTTP 协议版本（通常为 1.1）。然后，请联系您的 API 提供商，以获取进一步的帮助，以解决其内部系统中的任何潜在问题。

10. 507 存储不足错误

当服务器上没有足够的可用存储空间来满足 API 请求时，会发生此错误。

要排查此 API 错误，您可以提高您拥有的标准托管包，或者在页面流量过多时尝试优化存储库。

11. 检测到 508 循环错误

当服务器识别无限循环（API 请求循环）时，会发生此 API 错误。这可能是由于链中的重定向过多导致，这些重定向阻止了请求的资源或 URL 呈现。

要排查此 API 错误，请尝试确定导致循环的 API 调用，然后联系您的 API 提供商以获取解决任何基础问题的其他帮助。

总结 API 常见错误

API 错误可能由多种因素引起，从服务器级问题到不正确的 API 请求。请务必了解最常见的 API 错误以及如何识别这些错误以进行故障排除。

此外，在尝试排查 API 错误之前，确保您的互联网连接正常运行始终是一个好主意，因为这可能会影响某些 API 请求的结果。最后，定期监控 API 的性能也很重要，以便及早检测 API 错误并减轻其对用户的影响。

正确处理 API 错误后，可以快速解决这些错误，同时将对 API 客户端的中断降至最低。通过本指南，您应该更好地了解最常见的 API 错误以及如何识别和排除这些错误。