处理使用方 SDK 错误
消费者 SDK 使用回调向消费者应用发送行程更新错误
机制。回调参数是平台特定的返回值类型 (
TripUpdateError
以及
NSError
)。
提取状态代码
传递给回调函数的错误通常是 gRPC 错误,您也可以 从它们提取额外信息。对于 状态代码的完整列表,请参阅 状态代码及其在 gRPC 中的使用。
解读状态代码
状态代码涵盖两种错误:与服务器和网络相关的错误,以及 错误。
服务器和网络连接错误
以下状态代码针对的是网络错误或服务器错误, 无需采取任何措施来解决这些问题。使用方 SDK 会自动 能够从中恢复
状态代码 | 说明 |
---|---|
ABORTED | 服务器已停止发送响应。这通常是由 服务器问题。 |
已取消 | 服务器终止了外发响应。这通常
发生以下情况:
当应用被发送到后台时,或者当 消费者应用。 |
INTERRUPTED | |
DEADLINE_EXCEEDED | 服务器响应时间过长。 |
UNAVAILABLE | 服务器不可用。这通常是由网络所致 问题。 |
客户端错误
以下状态代码针对的是客户端错误,您必须采取措施 并加以解决。Consumer SDK 会继续重新尝试刷新行程,直到您 结束旅程分享,但在您采取行动后才能恢复。
状态代码 | 说明 |
---|---|
INVALID_ARGUMENT | 消费者应用指定的行程名称无效;行程名称必须
请遵循 providers/{provider_id}/trips/{trip_id} 格式。
|
NOT_FOUND | 此行程从未创建。 |
PERMISSION_DENIED | 消费者应用的权限不足。出现此错误的情况包括:
|
RESOURCE_EXHAUSTED | 资源配额为零,或者流量的速率超过 限速。 |
UNAUTHENTICATED | 由于 JWT 令牌无效,请求未通过身份验证。这个 如果 JWT 令牌签名时不含行程 ID,则会发生错误;或者 在 JWT 令牌过期时触发。 |