<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 调用，并检查问题是否已解决。