您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
问题
您可能会遇到以下一个或多个问题,这些问题是由开发者门户和 Edge 之间的通信问题引起的:
- 无法执行以下任务:
- 创建或更新 SmartDocs。
- 注册开发者应用。
- 列出 API 产品。
- 在开发者门户中访问 SmartDocs 模型页面时返回的错误(在开发者门户管理菜单中选择内容 > SmartDocs)。

- 开发者应用分析未生成。
错误消息
- 在开发者门户中访问“SmartDocs”标签页时返回的错误:
The website encountered an unexpected error. Please try again later.
- 在开发者门户中注册开发者应用时返回的错误:
There was an error trying to create the App. Please try again later.
可能的原因
在大多数情况下,问题是由于指定的 devadmin 凭据不正确或分配给 devadmin 用户角色的权限不足所致。
前往配置 > 开发者门户,确保“连接状态”字段显示“连接成功”,以验证开发者门户的 Edge 连接配置。否则,开发者门户将无法正确连接到 Edge 管理服务器。
诊断
- 在开发者门户上启用“DEBUG”日志记录,方法是前往配置 > 开发者门户,然后在“Edge 日志记录阈值”下选择“调试”。默认情况下,系统不会记录 Management API 调用。
- 重现问题。
- 依次前往报告 -> 近期日志消息,即可访问日志。

- 打开类型为“LogPlugin”的“消息”,详细了解实际错误。
显示 401 未经授权错误的输出示例

分辨率
请根据遇到的错误,按照下表中所列的相应步骤操作:
|
错误 |
解决步骤 |
|
401 未经授权 |
在开发者门户上更新正确的 devadmin 凭据,然后再次测试连接。请参阅添加和管理用户账号。 |
|
403 禁止访问 |
更新 Edge 组织上的 devadmin 用户角色,使其拥有资源所需的权限。请参阅设置用户角色和权限。 |