请参阅 Application Integration 支持的连接器

错误和错误处理

在 Application Integration 中,当您测试和发布集成时,或执行集成时可能会出错。这些错误可能是由各种客户端和服务器端问题引起的,它们大致分为以下内容:

  • 永久性错误:所有客户端错误(例如身份验证失败、数据验证错误)均视为永久性错误。永久性错误会导致永久性任务失败。
  • 暂时性错误:所有服务器端错误,例如 HTTP 503(服务不可用)、HTTP 400(错误请求)均视为暂时性错误。暂时性错误会导致临时任务失败。

错误消息显示在以下位置:

  • 执行日志页面:显示集成执行期间发生的错误。集成的每次执行都有一个单独的日志条目。如需了解执行日志页面,请参阅执行日志
  • 集成编辑器页面:显示发布集成时发生的错误。错误会显示在集成编辑器页面底部。如需了解集成编辑器页面,请参阅集成编辑器

如需了解您可能会遇到的错误代码列表,请参阅错误代码

错误处理方法

Application Integration 提供了多种错误处理方法,以对创建、测试、发布或运行集成时遇到的错误做出响应并从中恢复。您可以将错误处理方法用于集成执行的同步和异步模式:

Application Integration 支持以下错误处理方法,以便抛出、捕获、重试和自定义集成中遇到的错误:

错误代码

下表介绍了可能遇到的错误和相应的错误原因。Application Integration 使用 google.rpc.Code 中定义的规范错误代码。

如需了解 Application Integration 错误以及各种错误处理策略,请参阅错误和错误处理

标准异常类型 规范代码 HTTP 代码 说明
FailedPreconditionException FAILED_PRECONDITION 400 请求无法在当前系统状态下执行。
BadRequestException INVALID_ARGUMENT 400 客户端指定了无效参数。如需了解详情,请查看错误消息和错误详细信息。
UnauthenticatedException UNAUTHENTICATED 401 由于 OAuth 令牌丢失、无效或过期,请求未通过身份验证。
ForbiddenException PERMISSION_DENIED 403 客户端权限不足。如果 OAuth 令牌没有正确的范围、客户端没有所需的权限或 API 尚未启用,则可能会发生这种情况。
NotFoundException NOT_FOUND 404 未找到指定的资源。
AlreadyExistsException ALREADY_EXISTS 409 客户端尝试创建的资源已存在。
InternalError INTERNAL 500 内部服务器错误。通常是服务器错误。 如果任何任务或触发器配置不正确,则可能会发生这种情况。
UnimplementedException UNIMPLEMENTED 501 API 方法未通过服务器实现。
ServiceUnavailableException UNAVAILABLE 503 服务不可用。通常是服务器已关闭。
AbortedException ABORTED 409 响应大小过大。