开发者门户通信问题

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档
信息

问题

您可能会遇到以下一个或多个问题,这些问题是由开发者门户和 Edge 之间的通信问题引起的:

  1. 无法执行以下任务:
  2. 创建或更新 SmartDocs。
  3. 注册开发者应用。
  4. 列出 API 产品。
  5. 在开发者门户中访问 SmartDocs 模型页面时返回的错误(在开发者门户管理菜单中选择内容 > SmartDocs)。


  6. 开发者应用分析未生成。

错误消息

  1. 在开发者门户中访问“SmartDocs”标签页时返回的错误:

    The website encountered an unexpected error. Please try again later.
  2. 在开发者门户中注册开发者应用时返回的错误:

    There was an error trying to create the App. Please try again later.

可能的原因

在大多数情况下,问题是由于指定的 devadmin 凭据不正确或分配给 devadmin 用户角色的权限不足所致。

前往配置 > 开发者门户,确保“连接状态”字段显示“连接成功”,以验证开发者门户的 Edge 连接配置。否则,开发者门户将无法正确连接到 Edge 管理服务器。

诊断

  1. 在开发者门户上启用“DEBUG”日志记录,方法是前往配置 > 开发者门户,然后在“Edge 日志记录阈值”下选择“调试”。默认情况下,系统不会记录 Management API 调用。
  1. 重现问题。
  1. 依次前往报告 -> 近期日志消息,即可访问日志。

  1. 打开类型为“LogPlugin”的“消息”,详细了解实际错误。

显示 401 未经授权错误的输出示例

分辨率

请根据遇到的错误,按照下表中所列的相应步骤操作:

错误

解决步骤

401 未经授权

在开发者门户上更新正确的 devadmin 凭据,然后再次测试连接。请参阅添加和管理用户账号

403 禁止访问

更新 Edge 组织上的 devadmin 用户角色,使其拥有资源所需的权限。请参阅设置用户角色和权限