错误消息参考

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

本页面包含一些链接，指向在使用 Apigee Edge 时可能遇到的错误和其他问题问题排查策略方案。每个问题排查手册都介绍了如何诊断和解决每种类型的问题。

数据分析问题

以下主题介绍了如何排查 Analytics 数据未显示在 Analytics 信息中心或自定义报告中的问题。

错误消息或说明 Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Analytics（分析）报告超时

或者：

报告超时
除非 Postgres 服务器上的磁盘空间填满，否则您可能不会看到任何错误消息。 Postgres 服务器耗尽磁盘空间
未观察到错误。 自定义变量对 Google Analytics（分析）自定义报告不可见
No traffic in the selected date range 分析信息中心未显示数据
该主题介绍了如何执行经常请求的任务。 在分析群组中添加和删除分析组件
Could not get data for path 配置了多个 axgroup 时，自定义维度未显示

部署错误

API 代理的部署可能会因各种原因失败，例如边缘服务器之间的网络连接问题、Cassandra 数据存储区问题、ZooKeeper 异常以及 API 代理软件包中的错误。本部分介绍了排查部署错误时可遵循的一些特定过程的信息和指导。
错误消息或说明 Playbook
Error: Call timed out; either server is down or server is not reachable 超时错误
Unexpected error Error while fetching children for path 为路径提取子项时出错
Error while accessing datastore;Please retry later 访问 Datastore 时出错
Configuration failed, associated contexts = [] 配置失败
Unexpected error occurred while processing the updates, associated contexts = [] 错误处理更新

开发者门户错误

以下主题可帮助您解决使用开发者门户时可能遇到的问题。 在尝试解决开发者门户问题之前，请确保您对开发者门户的运作方式有基本的了解，如开发者门户问题排查概览中所述。
错误消息或说明 Playbook
An internal error has occurred. Please retry your request. 开发者门户内部错误
The website encountered an unexpected error. Please try again later. 或 There was an error trying to create the App. Please try again later. 开发者门户通信问题

变现方面的问题

以下主题可帮助您排查和解决常见的创收问题。

错误消息或说明 Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
开发者已被暂停
您可能不会看到任何错误消息，但会看到 创收设置问题的 问题部分所述的问题。 创收设置问题

边缘路由器问题

边缘路由器通过 NGINX 实现。在边缘升级过程中或更改路由器配置时，您可能会看到 NGINX 配置错误。以下主题将帮助您解决此类问题。

错误消息或说明 Playbook
您不会看到任何错误消息。但是，由于配置文件有问题，您可能无法执行 API 代理。 配置文件错误

OpenLDAP 问题

以下主题可帮助您排查和解决常见的 OpenLDAP 问题。

错误消息或说明 Playbook
Unknown username and password combination. SMTP 已停用，用户需要重置密码
没有错误，Edge 界面根本不会显示本应在所有 OpenLDAP 服务器上复制的用户列表。 LDAP 未复制。
SLAPD Dead But Pid File Exists 无法启动 OpenLDAP
Unknown username and password combination. OpenLDAP 数据损坏

运行时错误

以下主题可帮助您排查和解决常见的运行时问题。

错误消息或说明 Playbook
HTTP/1.1 500 Internal Server Error 或 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
500 内部服务器错误
HTTP/1.1 502 Bad Gateway 或 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 网关错误
HTTP/1.1 503 Service Unavailable 或 HTTP/1.1 503 Service Unavailable: Back-end server is at capacity 或 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 Service Available（服务不可用）
HTTP/1.1 503 Service Unavailable 或 Received fatal alert: handshake_failure SSL 握手失败
HTTP/1.1 503 Service Unavailable 或 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL 握手失败 - 客户端证书无效
HTTP/1.1 504 Gateway Timeout 或 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 网关超时

ZooKeeper 问题

以下主题可帮助您排查和解决常见的 ZooKeeper 问题。
错误消息或说明 Playbook
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

或

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

或

Edge 界面可能会显示以下错误：

Error Fetching Deployments Error while checking path existence for path: path 		Zookeeper 连接丢失错误
数据相关问题（通常称为布线问题）可以表现为多种问题之一。请参阅 Zookeeper 数据问题了解详情。 Zookeeper 数据问题
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] 无法启动 ZooKeeper

诊断工具和日志

以下主题介绍了可用于帮助诊断使用 Apigee Edge 时可能遇到的某些类型的问题的工具和日志。

  • TCP/IP 数据包嗅探器 (tcpdump) 实用程序
    tcpdump 工具是一种命令行数据包嗅探器工具，可让您捕获或过滤通过网络接收或传输的 TCP/IP 数据包。
  • 堆转储
    堆转储是 Java 进程内存的快照。它们包含在收集堆转储时堆中 Java 对象和类的相关信息。
  • 线程转储
    线程转储是正在运行的 Java 进程的所有线程的状态快照。每个线程的状态都会与其堆栈的内容一起显示，称为堆栈轨迹。