---
title: 错误处理
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/ios/error-handling
locale: zh-CN
generated_by: markdown-export
---

iOS SDK 的所有错误处理集中在本节。`onErrorAcessoBioManager` 回调接收一个 `ErrorBio` 对象，该对象暴露 `getCode()` 和 `getDescription()`。

## 错误代码

| 代码 | 描述 |
|---|---|
| `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 token |
| `73701` | 找不到活体检测导入 |
| `73702` | 无法在生产模式下初始化活体检测 |
| `73703` | 无法获取活体检测会话 |
| `73704` | 用户按下取消按钮，未完成会话 |
| `73705` | 会话未成功执行，未生成 FaceScan |
| `73706` | 相机访问被拒绝——用户明确拒绝了权限或设备策略阻止了访问 |
| `73707` | 会话因应用终止、休眠、系统通知或进入后台而被取消 |
| `73708` | 会话因设备处于横屏模式而被取消 |
| `73709` | 会话因设备处于反向竖屏模式而被取消 |
| `73710` | 会话因用户在规定超时时间内未能完成而被取消 |
| `73711` | 会话因内存压力而被取消 |
| `73712` | 会话因应用不在生产环境且需要网络连接而被取消 |
| `73713` | 会话因密钥需要重新验证而被取消 |
| `73714` | 会话因开发者配置的加密密钥无效而被取消 |
| `73715` | 会话因未配置所有引导图像而被取消 |
| `73716` | 会话因 SDK 无法在此设备上启动相机而被取消 |
| `73717` | 会话因用户处于锁定状态而被取消 |
| `73718` | 正常使用 iOS API 时发生未知且意外的错误 |
| `73719` | 会话因用户按下准备页面的副文本消息而被取消 |
| `73720` | 会话未被处理 |
| `73721` | 无法执行会话：已超出尝试次数限制 |
| `73722` | 无法执行会话：人脸对齐超时 |
| `73730` | 无法初始化活体检测会话——未知许可证错误 |
| `73731` | 无法初始化活体检测会话——许可证已过期 |
| `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()`
:::