---
title: 오류 처리
canonical: https://developer.unico.io/ko/dual-api/developers/sdks-and-tools/ios/error-handling
locale: ko
generated_by: markdown-export
---

iOS SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. `onErrorAcessoBioManager` 콜백은 `getCode()`와 `getDescription()`을 노출하는 `ErrorBio` 객체를 수신합니다.

## 오류 코드

| 코드 | 설명 |
|---|---|
| `73000` | 알 수 없고 예기치 않은 오류로 인해 세션이 취소되었습니다. Unico Check SDK는 카메라, 저장소, 보안, 네트워킹 등 다양한 iOS API를 활용합니다 — 이는 모든 오류를 포괄하는 코드입니다. |
| `73001` | 컨텍스트가 유효하지 않음 |
| `73003` | API 버전은 13 이상이어야 합니다 |
| `73006` | 에뮬레이터에서 카메라를 열 수 없음 |
| `73100` | 인터넷에 연결할 수 없음 |
| `73200` | unico_sdk JSON 파일을 찾을 수 없음 |
| `73202` | unico_sdk JSON 파일을 로드할 수 없음 |
| `73203` | `AcessoBioConfigDataSource`를 로드할 수 없음 |
| `73204` | SDK를 초기화할 수 없음 — 빌드 시 `setEnvironment`를 통해 환경을 구성하세요 |
| `73300` | unico 인증 객체를 가져올 수 없음 |
| `73301` | unico 인증 객체를 파싱할 수 없음 |
| `73302` | unico 토큰을 찾을 수 없음 |
| `73701` | 활성 liveness 가져오기를 찾을 수 없음 |
| `73702` | 프로덕션 모드에서 활성 liveness를 초기화할 수 없음 |
| `73703` | 활성 liveness 세션을 가져올 수 없음 |
| `73704` | 사용자가 취소 버튼을 눌러 세션을 완료하지 않았습니다 |
| `73705` | 세션이 성공적으로 수행되지 않아 FaceScan이 생성되지 않았습니다 |
| `73706` | 카메라 접근이 거부됨 — 사용자가 명시적으로 권한을 거부했거나 기기 정책에 의해 차단되었습니다 |
| `73707` | 앱 종료, 절전 모드, OS 알림 또는 백그라운드 전환으로 인해 세션이 취소되었습니다 |
| `73708` | 기기가 가로 모드이기 때문에 세션이 취소되었습니다 |
| `73709` | 기기가 역 세로 모드이기 때문에 세션이 취소되었습니다 |
| `73710` | 허용된 제한 시간 내에 사용자가 세션을 완료하지 못해 취소되었습니다 |
| `73711` | 메모리 부족으로 인해 세션이 취소되었습니다 |
| `73712` | 앱이 프로덕션 상태가 아니어서 네트워크 연결이 필요하여 세션이 취소되었습니다 |
| `73713` | 키 재검증이 필요하여 세션이 취소되었습니다 |
| `73714` | 개발자가 구성한 암호화 키가 유효하지 않아 세션이 취소되었습니다 |
| `73715` | 모든 안내 이미지가 구성되지 않아 세션이 취소되었습니다 |
| `73716` | SDK가 이 기기에서 카메라를 시작할 수 없어 세션이 취소되었습니다 |
| `73717` | 사용자가 잠금 상태에 있어 세션이 취소되었습니다 |
| `73718` | iOS API 정상 사용 중 알 수 없고 예기치 않은 오류 |
| `73719` | 사용자가 준비 화면의 하위 텍스트 메시지를 눌러 세션이 취소되었습니다 |
| `73720` | 세션이 처리되지 않았습니다 |
| `73721` | 세션을 수행할 수 없습니다: 시도 횟수 초과 |
| `73722` | 세션을 수행할 수 없습니다: 얼굴 정렬 시간 초과 |
| `73730` | 활성 liveness 세션을 초기화할 수 없음 — 알 수 없는 라이선스 오류 |
| `73731` | 활성 liveness 세션을 초기화할 수 없음 — 라이선스 만료됨 |
| `73800` | 암호화된 키를 생성할 수 없음 |

:::secondary[공식 오류 카탈로그]
위의 코드는 iOS SDK 카탈로그를 반영합니다. 공식 크로스 플랫폼 오류 코드 카탈로그는 [API 참조 > 오류 코드](/dual-api/developers/api-reference/error-codes)에서 확인할 수 있습니다.
:::

## 수명 주기 콜백

`onErrorAcessoBioManager` 외에도 SDK는 다음을 트리거합니다:

- `onUserClosedCameraManually()` — 사용자가 카메라를 수동으로 닫았습니다.
- `onSystemClosedCameraTimeoutSession()` — 시간 초과로 인해 세션이 만료되었습니다 (기본값 40초, 최소 40초).
- `onSystemChangedTypeCameraTimeoutFaceInference()` — 얼굴 감지가 13초 임계값을 초과했습니다; 캡처가 수동 모드로 전환됩니다.

:::info[취소 및 타임아웃에 대한 콜백 라우팅]
오류 `73704`(사용자 취소) 및 `73710`(세션 타임아웃)은 `onErrorAcessoBioManager`를 통해 전달되지 **않습니다**. 해당 수명 주기 콜백을 직접 트리거합니다:
- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`
:::