• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 lockout.
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## 12700001 人脸录入过程中的操作失败
141
142**错误信息**
143
144The operation is failed.
145
146**可能原因**
147
1481. 例如调用faceAuth模块的setSurfaceId接口时，人脸认证服务未启动，则会返回12700001错误码。
1492. IPC通信的proxy客户端写数据出错。
1503. IPC通信的stub服务端解析数据出错。
1514. 人脸driver层调用出错。
152
153**处理步骤**
154
155系统服务内部工作异常，请稍后重新调用接口，或者重启设备尝试。
156