소비자 SDK 오류 처리
소비자 SDK는 콜백 메커니즘을 사용하여 소비자 앱에 경로 업데이트 오류를 전송합니다. 콜백 매개변수는 플랫폼별 반환 유형입니다(Android의 경우 TripUpdateError
, iOS의 경우 NSError
).
상태 코드 추출
콜백에 전달되는 오류는 일반적으로 gRPC 오류이며 상태 코드 형태로 추가 정보를 추출할 수도 있습니다. 상태 코드의 전체 목록은 상태 코드 및 gRPC에서 상태 코드 사용을 참조하세요.
Java
onTripUpdateError()
에서 반환된 TripUpdateError
에서 오류에 대한 세부정보를 제공하는 gRPC 상태 코드를 추출할 수 있습니다.
// Called when there is a trip update error.
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
Status.Code code = error.getStatusCode();
}
Kotlin
onTripUpdateError()
에서 반환된 TripUpdateError
에서 오류에 대한 세부정보를 제공하는 gRPC 상태 코드를 추출할 수 있습니다.
// Called when there is a trip update error.
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
val code = error.getStatusCode()
}
Swift
NSError
는 tripModel(_:didFailUpdateTripWithError:)
에서 다시 호출됩니다.
// Called when there is a trip update error.
func tripModel(_ tripModel: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
// Check to see if the error comes from gRPC.
if let error = error as NSError?, error.domain == "io.grpc" {
let gRPCErrorCode = error.code
...
}
}
Objective-C
NSError
는 tripModel:didFailUpdateTripWithError:
에서 다시 호출됩니다.
// Called when there is a trip update error.
- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(NSError *)error {
// Check to see if the error comes from gRPC.
if ([error.domain isEqualToString:@"io.grpc"]) {
NSInteger gRPCErrorCode = error.code;
...
}
}
상태 코드 해석
상태 코드에는 서버 및 네트워크 관련 오류와 클라이언트 측 오류라는 두 가지 종류의 오류가 있습니다.
서버 및 네트워크 오류
다음 상태 코드는 네트워크 또는 서버 오류에 대한 것이므로 이를 해결하기 위해 조치를 취할 필요가 없습니다. 소비자 SDK는 이러한 데이터를 자동으로 복구합니다.
상태 코드 | 설명 |
---|---|
ABORTED | 서버에서 응답 전송을 중지했습니다. 이 문제는 일반적으로 서버 문제로 인해 발생합니다. |
CANCELLED | 서버가 발신 응답을 종료했습니다. 이는 일반적으로 앱이 백그라운드로 전송되거나 소비자 앱에서 상태가 변경될 때 발생합니다. |
INTERRUPTED | |
DEADLINE_EXCEEDED | 서버가 응답하는 데 시간이 너무 오래 걸립니다. |
현재 구매할 수 없음 | 서버를 사용할 수 없습니다. 이 문제는 일반적으로 네트워크 문제로 인해 발생합니다. |
클라이언트 오류
다음 상태 코드는 클라이언트 오류용이며 이를 해결하려면 조치를 취해야 합니다. 소비자 SDK는 여정 공유를 종료할 때까지 경로 새로고침을 계속 시도하지만 조치를 취할 때까지 복구되지 않습니다.
상태 코드 | 설명 |
---|---|
INVALID_ARGUMENT | 소비자 앱에서 잘못된 경로 이름을 지정했습니다. 경로 이름은 providers/{provider_id}/trips/{trip_id} 형식을 따라야 합니다.
|
NOT_FOUND | 이동이 생성되지 않았습니다. |
PERMISSION_DENIED | 소비자 앱의 권한이 충분하지 않습니다. 이 오류는 다음과 같은 경우에 발생합니다.
|
RESOURCE_EXHAUSTED | 리소스 할당량이 0이거나 트래픽 흐름 속도가 속도 제한을 초과합니다. |
UNAUTHENTICATED | 잘못된 JWT 토큰으로 인해 요청이 인증에 실패했습니다. 이 오류는 JWT 토큰이 이동 ID 없이 서명되었거나 JWT 토큰이 만료된 경우에 발생합니다. |