<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
问题
使用开发者提供的 SmartDocs 发出实时 API 请求时遇到错误 。
错误消息
开发者门户上出现的常见错误是“发生了内部错误。 请重试您的请求”。
可能的原因
如果开发者门户无法从后端获得响应 (smartdocs),则可能会发生此错误 代理或实际端点)。
诊断
<ph type="x-smartling-placeholder"></ph> 在浏览器中启用“开发者工具”,然后查看“网络”标签页 找出实际错误
下表列出了常见的错误及其典型原因:
错误 |
典型原因 |
ERR_NAME_NOT_RESOLVED |
|
混合内容 |
|
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”代理诊断错误 。如需了解详情,请参阅使用跟踪工具。
- 在以下位置启用对“smartdocs”代理的跟踪: “VALIDATE”组织,以查找 返回 500 内部服务器错误。
- 选择跟踪记录中的特定政策以确定错误的原因。
分辨率
修正发现的错误。如果您需要帮助,请联系 Apigee Edge 支持团队。
边缘消息处理器无法调用已发布的 API 端点
500 - 当属于 托管 Smartdocs 代理的组织无法调用 API 端点。
诊断
如所述,使用“跟踪”工具通过“smartdocs”代理诊断错误 。如需了解详情,请参阅使用跟踪工具。
- 为“smartdocs”启用 trace “VALIDATE”组织中的代理来查找特定政策 返回 500 内部服务器错误。
- 在上面显示的示例界面跟踪记录中,可以看到,JavaScript 政策 “BuildTargetAPIRequest”无法执行目标网址。
- 从 JavaScript 政策获取目标网址 “BuildTargetAPIRequest”
- 从与
“VALIDATE”组织,如下所示:
curl -v <target URL>
- 更正观察到的任何错误。
分辨率
- 确保可以从消息处理器调用开发者门户上发布的 API 与“VALIDATE”组织相关联,并更正所有错误 错误。
- 如果能够直接从消息处理器执行 API 调用, 您也应该能够通过 SmartDocs 执行 API。
- 通过 SmartDocs 执行 API 调用,并检查问题是否已解决。