客户端运行过程中，可能会出现异常报错，将对应报错分为：网络底层异常报错、客户端用户界面报错，详细说明如下。
若存在问题根据解决方案无法进行解决，请联系我们 ，并携带相应信息。
- 问题现象，携带报错截图或报错编码。
- 版本号：可通过客户端-设置查看版本号。
- 系统版本：如Windows 11。
- 客户端日志： 导出客户端日志。
网络底层异常报错
网络底层错误码以0x0开头，出现错误无法自动修复后，将会发送给客户端用户界面进行错误提示，并携带必要处理动作。
| 错误编码 | 错误原因 | 错误类型 | 解决方案 |
|---|---|---|---|
| 0x0001 | 应用资源格式异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0002 | 应用资源返回异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0003 | 控制中心的隧道资源格式异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0004 | 控制中心的隧道资源返回异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0005 | 认证中心返回异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0006 | 登录中心返回异常 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0007 | MAC的本地DNS端口冲突，比如5953是否被占用等 | 软件冲突 | 运行的软件可能与零信任客户端冲突，请关闭软件后再次启动零信任客户端。 |
| 0x0008 | MAC的本地dns为空 | 网络或DNS异常 | 尝试切换网络后重新登录，若仍未恢复，请检查设备的DNS配置。 |
| 0x0009 | Windows调用底层流量劫持失败 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0010 | Windows启动隧道异常 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0011 | Windows获取边缘节点地址异常 | 网络或DNS异常 | 请检查或尝试切换网络。若仍未恢复，请检查设备的DNS配置。 |
| 0x0012 | windows创建网络适配器异常 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0013 | windows开启网卡驱动日志异常 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0014 | 启动配置解析认证中心域名异常 | 客户端异常 | 如果使用了配置文件，请检查配置项格式是否正确，如果未使用，请重新安装零信任客户端并重新登录。 |
| 0x0016 | 秘钥创建异常 | 客户端异常 | 请重新安装零信任客户端，并重新登录。 |
| 0x0017 | 私钥创建异常 | 客户端异常 | 请重新安装零信任客户端，并重新登录。 |
| 0x0018 | 公钥创建异常 | 客户端异常 | 请重新安装零信任客户端，并重新登录。 |
| 0x0019 | MAC进程异常重启 | 客户端异常 | 请尝试重新登录。 |
| 0x0020 | 认证中心返回的隧道节点为空 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0021 | Windows网卡配置加载失败 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0022 | Windows网卡启动失败，未找到vpn网卡 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0026 | sdk认证返回异常 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0027 | 认证请求不合法 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0031 | 没有可用节点 | 服务端异常 | 请重新启动零信任客户端并登录。 |
| 0x0043 | 隧道watchdog 配置网卡超时 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0033 | 错误的节点索引 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x0036 | 未配置连接器，隧道创建失败 | 服务端异常 | 请先上控制台配置对应连接器。 |
| 0x0037 | 认证中心通告，未匹配上报的节点 | 服务端异常 | 网络异常，请检查DNS设置，关闭其他VPN代理软件再重新登录。若未解决，可用诊断工具检测。 |
客户端用户界面报错
客户端用户界面错误码以0x1开头，出现错误无法自动修复后，也会进行用户界面提示错误。
| 错误编码 | 错误原因 | 错误类型 | 解决方案 |
|---|---|---|---|
| 0x1000 | 调用client的IPC接口超时 | 客户端异常 | 重试刚刚执行的操作。 |
| 0x1001 | 准备调用client的IPC接口，但与client的IPC连接已断开 | 客户端异常 | 重试刚刚执行的操作。 |
| 0x1002 | 调用了client的IPC接口，等待client发回响应的过程中检测到IPC连接意外断开 | 客户端异常 | 重试刚刚执行的操作。 |
| 0x1003 | 尝试修复client服务时，发现安装包文件不存在 | 客户端异常 | 检查杀毒软件是否将安装包拦截，若被拦截则将此程序加到exe里。 |
| 0x1004 | 尝试修复client服务时，出现其他未识别的错误 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x1005 | 修复client服务后，重新通知client上线失败 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x1006 | 登录成功后，超过一定时间(180s)仍未收到底层反馈隧道网络打通情况 | 客户端异常 | 请重新启动零信任客户端并登录。 |
| 0x1007 | 请求服务端接口时，服务端响应了未定义的报错 | 服务端异常 | 重试刚刚执行的操作。 |
