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错误码。
134调用start接口发起人脸认证，但是目前的设备没有录入人脸凭据，则会返回12500010错误码。
135
136**处理步骤**
137
138检查是否录入该类型的凭据，如果没有录入，则需要成功录入该类型凭据后再调用相关接口。
139
140## 12500011 提示/通知切换自定义认证
141
142**错误信息**
143
144Switched to the custom authentication process.
145
146**可能原因**
147
148当前的认证操作被用户从控件取消，返回这个错误码，标识使用应用自定义认证。例如用户点击使用自定义认证，返回到应用自定义认证流程。
149
150**处理步骤**
151
152重新调用认证接口，发起认证。
153
154## 12500013 密码过期
155
156**错误信息**
157
158Operation failed because of PIN expired.
159
160**可能原因**
161
162由于系统锁屏密码过期，认证操作执行失败。当用户发起口令、指纹或者人脸认证，但是系统锁屏密码过期时，将会返回12500013错误码。
163
164**处理步骤**
165
166用户前往设置更新系统锁屏密码，再次发起认证。
167
168## 12700001 人脸录入过程中的操作失败
169
170**错误信息**
171
172Operation failed.
173
174**可能原因**
175
1761. 例如调用faceAuth模块的setSurfaceId接口时，人脸认证服务未启动，则会返回12700001错误码。
1772. IPC通信的proxy客户端写数据出错。
1783. IPC通信的stub服务端解析数据出错。
1794. 人脸driver层调用出错。
180
181**处理步骤**
182
183系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。
184