开发者门户内部错误

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

问题

使用开发者提供的 SmartDocs 发出实时 API 请求时遇到错误 。

错误消息

开发者门户上出现的常见错误是“发生了内部错误。 请重试您的请求”。

可能的原因

如果开发者门户无法从后端获得响应 (smartdocs),则可能会发生此错误 代理或实际端点)。

诊断

<ph type="x-smartling-placeholder"></ph> 在浏览器中启用“开发者工具”,然后查看“网络”标签页 找出实际错误

下表列出了常见的错误及其典型原因:

错误

典型原因

ERR_NAME_NOT_RESOLVED

SmartDocs 代理配置错误或网络防火墙 限制

混合内容

门户通过 HTTPS 配置,SmartDocs 请求通过 HTTP

500 - 内部服务器错误

下面我们将逐一介绍上述每种原因,以及解决相应问题的步骤。

SmartDocs 代理配置错误或网络防火墙 限制

ERR_NAME_NOT_RESOLVED”消息表示 Smartdocs 代理网址配置错误,或访问门户所在的网络为 由于防火墙限制,无法调用 smartdocs 代理网址。Smartdocs 必须可通过互联网或内部网络(针对内部 API)访问代理。

分辨率

确保可以从所有必需的网络访问 smartdocs 代理,方法是部署 将 Smartdocs 代理连接到 Edge 上的虚拟主机(其主机名为 。

通过 HTTPS 配置的门户,通过 HTTP 进行 SmartDocs 请求

混合内容”错误表示 smartdocs 代理 。

分辨率

通过 https 提供 smartdocs 代理以解决此问题。为此,您可以将 Smartdocs 代理,包含配置为使用 TLS/SSL 的虚拟主机 (通常是“安全”虚拟主机)。

SmartDocs 代理返回异常

500 - 内部服务器错误消息可能是由 “smartdocs”代理在此示例中,您会发现 Smartdocs 代理返回了 错误。

诊断

如所述,使用“跟踪”工具通过“smartdocs”代理诊断错误 。如需了解详情,请参阅使用跟踪工具

  1. 在以下位置启用对“smartdocs”代理的跟踪: “VALIDATE”组织,以查找 返回 500 内部服务器错误。

  1. 选择跟踪记录中的特定政策以确定错误的原因。

分辨率

修正发现的错误。如果您需要帮助,请联系 Apigee Edge 支持团队

边缘消息处理器无法调用已发布的 API 端点

500 - 当属于 托管 Smartdocs 代理的组织无法调用 API 端点。

诊断

如所述,使用“跟踪”工具通过“smartdocs”代理诊断错误 。如需了解详情,请参阅使用跟踪工具

  1. 为“smartdocs”启用 traceVALIDATE”组织中的代理来查找特定政策 返回 500 内部服务器错误。

  1. 在上面显示的示例界面跟踪记录中,可以看到,JavaScript 政策 “BuildTargetAPIRequest”无法执行目标网址。
  1. 从 JavaScript 政策获取目标网址 “BuildTargetAPIRequest
  1. 从与 “VALIDATE”组织,如下所示:
    curl -v <target URL>
    
  1. 更正观察到的任何错误。

分辨率

  1. 确保可以从消息处理器调用开发者门户上发布的 API 与“VALIDATE”组织相关联,并更正所有错误 错误。
  1. 如果能够直接从消息处理器执行 API 调用, 您也应该能够通过 SmartDocs 执行 API。
  1. 通过 SmartDocs 执行 API 调用,并检查问题是否已解决。