注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

了解 HTTP 错误代码

本指南旨在提供有关如何应对在与网页前端交互时遇到的HTTP错误代码的基本信息。虽然许多技术通常适用于任何网页界面,但我们将在使用Palantir平台的背景下描述它们。


什么是HTTP错误代码?

当您尝试打开一个网页时,您的浏览器会向服务器发送一系列请求以获取页面内容。目的是服务器接收您的请求,检查它们以确定应该提供什么内容,然后发送包含正确内容的响应。然后您的浏览器将内容拼凑起来显示页面。

本指南稍后将深入探讨请求的概念,但这里我们专注于响应。服务器返回的每个响应总是包含一个状态代码。状态代码表示服务器给您的响应的状态。它由一个三位数表示,具有相应的含义(通常由互联网工程任务组定义)。当页面加载失败时,您可能会看到这些状态代码 - 像"404"这样的术语可能对您很熟悉。在这里,我们将深入了解每个代码的含义,以及如何使用这些信息找到一些简单的修复方法或更好的错误报告。

在响应中发送的三位数的第一位表示状态类别。本指南的重要类别是:

  • 2xx:如果代码以2开头,则表示请求成功。完整代码通常是200,表示一般的成功请求和响应。
  • 4xx:如果代码以4开头,则表示请求由于客户端错误而未成功。客户端指的是发出请求的实体,通常是您使用的浏览器或网页。我们将在下面看到一些这些代码的示例。
  • 5xx:如果代码以5开头,则表示请求由于服务器错误而未成功。这通常意味着您的请求格式正确且制作良好,但当服务器检查它并尝试确定要发送回的响应时,出了点问题。我们将在下面看到一些这些代码的示例。

现在让我们深入了解一些实际的代码。请注意,这个列表并不详尽,如果您遇到此处未列出的数字,可以参考HTTP状态代码完整列表↗


客户端错误

400 - 错误请求

此错误消息表示您发送到服务器的请求内部有问题。Palantir开发人员努力确保很少遇到此错误代码,因为最常见的原因是请求语法错误,通常在底层代码中定义。然而,一个常见的"错误请求"错误原因是请求过大,导致请求中包含的数据太多,服务器无法处理。

返回顶部


401 - 未授权

您更常见到的是"403 - 禁止访问",而不是"401 - 未授权",但它们在语义上非常相似。通常,401错误表示您的请求格式正确,但您未被授权进行该请求。与403不同的是,它通常用于您尝试进行授权但授权失败的情况,或者您已被标记为"被禁"。

返回顶部


403 - 禁止访问

禁止访问错误表示您进行了一个不被允许的请求。如果存在一个访问控制列表(ACL)规则,说明您不被允许访问您尝试访问的资源,您可能会在Palantir平台中遇到此错误。例如,某些数据您的用户不被允许查看,但这也适用于服务。例如,如果您的用户不被允许访问数据沿袭应用程序,当您尝试这样做时,您可能会看到"403 - 禁止访问"。

返回顶部


404 - 未找到

此错误表示您请求的资源不存在。例如,如果某个特定资产被移除,访问该资产会显示为"404 - 未找到",因为您请求的资源不存在。


服务器错误代码

500 - 服务器内部错误

此错误表示服务器接收到请求并需要执行内部操作以生成响应。然而,在此过程中服务器内部发生了错误。

例如,假设您的服务器任务是接收包含两个数字的请求,然后将第一个数字除以第二个数字。在此示例中,如果您向服务器发送"8"和"2"的请求,它将返回状态代码200(成功),响应将包含答案"4"。但是,如果您发送"5"和"0",您可能会看到"500 - 服务器内部错误",因为当服务器尝试计算5/0时,它在内部引发了错误。在Palantir平台的上下文中,这意味着您需要查看相关服务的内部,以确定内部发生了什么错误。这通常意味着识别服务并查找相关日志,我们将在本指南后面进行介绍。

返回顶部


502 - 错误网关

"网关"一词指的是服务之间连接的背后存在"间接"的元素。假设您尝试打开https://foundry.link/workspace/magic-app时遇到此错误。实际上发生的是您的请求到达一个服务器("网关"服务器),然后网关服务器将您的请求传递出去。值得注意的是,magic-app可能运行在与网关不同的服务器上,因此网关必须向该服务器(称为"上游服务器")请求响应,并打算将该响应返回给您。此错误表示上游服务器返回了无效响应。

返回顶部


503 - 服务不可用

此错误表示服务存在,因为否则将会收到404错误。然而,服务无法处理您的请求,最常见的原因是服务已停机或过载。例如,如果Contour有太多请求,根本无法处理更多请求,您可能会收到"503 - 服务不可用"。这可能是由于计算资源不足或内部错误,例如内存泄漏。

返回顶部


504 - 网关超时

此错误类似于"502 - 错误网关",不同之处在于网关服务器发出了正确的请求,但未从上游服务器及时收到响应。这可能由于各种原因,包括网络连接问题、服务器停机或服务器过载。当发生504错误时,通常表示您尝试访问的网站或网络应用程序暂时不可用。通常这不是您自己的设备或互联网连接的问题。

返回顶部