1# 用户认证错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 6 7## 12500001 认证失败 8 9**错误信息** 10 11Authentication failed. 12 13**可能原因** 14 15当前凭据与设备里已经录入的凭据比对失败。 16 17**处理步骤** 18 19重新发起认证。 20 21## 12500002 一般的操作错误 22 23**错误信息** 24 25General operation error. 26 27**可能原因** 28 291. NAPI层解析参数出错。 302. 用户认证服务的进程没有启动。 313. IPC通信的proxy客户端写数据出错。 324. IPC通信的stub服务端解析数据出错。 335. 获取driver服务出错。 34 35**处理步骤** 36 37系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。 38 39## 12500003 认证被取消 40 41**错误信息** 42 43Authentication canceled. 44 45**可能原因** 46 47当前的认证操作已经被取消。 48 49**处理步骤** 50 51重新调用认证接口，发起认证。 52 53## 12500004 认证操作超时 54 55**错误信息** 56 57Authentication timeout. 58 59**可能原因** 60 61当前的认证操作超过了设定的时限。 62 63**处理步骤** 64 65重新调用认证接口，发起认证。 66 67## 12500005 认证类型不支持 68 69**错误信息** 70 71The authentication type is not supported. 72 73**可能原因** 74 751. 传入的认证类型参数不支持，例如调用userAuth模块的getAvailableStatus接口时传入的参数不是FACE或FINGERPRINT类型，则会返回12500005错误码。 762. 传入的认证类型参数在本设备上不支持，例如在没有部署指纹传感器的设备上发起指纹认证，则会返回12500005错误码。 77 78**处理步骤** 79 80请检查传入的认证类型参数，重新调用接口。 81 82## 12500006 认证信任等级不支持 83 84**错误信息** 85 86The authentication trust level is not supported. 87 88**可能原因** 89 901. 调用userAuth模块的getAvailableStatus或getAuthInstance接口时，传入的authTrustLevel参数不在[ATL1, ATL2, ATL3, ATL4]范围内。 912. 当前的设备不支持该认证信任等级，例如在只部署了2D摄像头的设备上发起支付级别的人脸认证，则会返回12500006错误码。 92 93**处理步骤** 94 95检查传入的authTrustLevel是否在合理范围，如果在合理范围，则是当前的设备不支持该认证信任等级。 96 97## 12500007 认证服务已经繁忙 98 99**错误信息** 100 101Authentication service is busy. 102 103**可能原因** 104 105当前已经存在某个尚未结束的认证，又发起了一次认证。 106 107**处理步骤** 108 109稍后重新发起认证。 110 111## 12500009 认证被锁定 112 113**错误信息** 114 115Authentication is locked out. 116 117**可能原因** 118 119当前认证失败的次数超过了上限，触发防爆模式，认证被锁定。 120 121**处理步骤** 122 123稍后重新发起一次成功的认证。 124 125## 12500010 该类型的凭据没有录入 126 127**错误信息** 128 129The type of credential has not been enrolled. 130 131**可能原因** 132 133例如调用userAuth模块的getAvailableStatus接口，传入的authType参数为FACE，但是当前的设备没有录入人脸凭据，则会返回12500010错误码。调用start接口发起人脸认证，但是目前的设备没有录入人脸凭据，则会返回12500010错误码。 134 135**处理步骤** 136 137检查是否录入该类型的凭据，如果没有录入，则需要成功录入该类型凭据后再调用相关接口。 138 139## 12500011 提示/通知切换自定义认证 140 141**错误信息** 142 143Switched to the custom authentication process. 144 145**可能原因** 146 147当前的认证操作被用户从控件取消，返回这个错误码，标识使用应用自定义认证。例如用户点击使用自定义认证，返回到应用自定义认证流程。 148 149**处理步骤** 150 151重新调用认证接口，发起认证。 152 153## 12500013 密码过期 154 155**错误信息** 156 157Operation failed because of PIN expired. 158 159**可能原因** 160 161由于系统锁屏密码过期，认证操作执行失败。当用户发起口令、指纹或者人脸认证，但是系统锁屏密码过期时，将会返回12500013错误码。 162 163**处理步骤** 164 165用户前往设置更新系统锁屏密码，再次发起认证。 166 167<!--Del--> 168## 12500015 AuthToken完整性校验失败 169 170**错误信息** 171 172Operation failed because of authToken integrity check failed. 173 174**可能原因** 175 176当验证的AuthToken无效时，会返回12500015错误码。 177 178**处理步骤** 179 180重新发起认证，签发有效token。 181 182## 12500016 AuthToken过期 183 184**错误信息** 185 186Operation failed because of authToken has expired. 187 188**可能原因** 189 190当AuthToken的签发时间至发起验证时的时间间隔超过传入的最大有效时长时，会返回12500016错误码。 191 192**处理步骤** 193 194重新发起认证，签发有效token。 195<!--DelEnd--> 196 197## 12700001 人脸录入过程中的操作失败 198 199**错误信息** 200 201Operation failed. 202 203**可能原因** 204 2051. 例如调用faceAuth模块的setSurfaceId接口时，人脸认证服务未启动，则会返回12700001错误码。 2062. IPC通信的proxy客户端写数据出错。 2073. IPC通信的stub服务端解析数据出错。 2084. 人脸driver层调用出错。 209 210**处理步骤** 211 212系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。 213