错误消息参考

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

本页面包含指向问题排查手册的链接，可帮助您排查使用 Apigee Edge 时可能遇到的错误和其他问题。每份问题排查手册都介绍了如何诊断和解决每种类型的问题。

Google Analytics 问题

这些主题介绍了如何排查 Google Analytics 数据未显示在 Google Analytics 信息中心或自定义报告中的情况。

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

Google Analytics 报告超时

或者：

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

部署错误

API 代理的部署可能会因各种原因而失败，例如 Edge 服务器之间的网络连接问题、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 实现的。在 Edge 升级过程中或更改路由器的配置时，您可能会看到 NGINX 配置错误。以下主题可帮助您解决此类问题。

错误消息或说明 Playbook
您不会看到任何错误消息。不过，由于配置文件有误，您可能无法执行 API 代理。 配置文件有误
429 Too Many Requests: Tuning Nginx Router connection limits 429 请求过多

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 服务不可用
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 进程的所有线程状态的快照。每个线程的状态都显示其堆栈的内容，称为堆栈轨迹。