• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 关键资产存储服务(ASSET)错误码
2
3<!--Kit: Asset Store Kit-->
4<!--Subsystem: Security-->
5<!--Owner: @JeremyXu-->
6<!--Designer: @skye_you-->
7<!--Tester: @nacyli-->
8<!--Adviser: @zengyawen-->
9
10> **说明:**
11>
12> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。
13
14## 24000001 关键资产服务不可用
15
16**错误信息**
17
18The ASSET service is unavailable.
19
20**可能原因**
21
22系统异常导致关键资产服务不可用。
23
24**处理步骤**
25
26重新发起关键资产处理请求。
27
28## 24000002 未找到关键资产
29
30**错误信息**
31
32The asset is not found.
33
34**可能原因**
35
361. 关键资产从未写入过。
372. 关键资产已经删除。
38
39**处理步骤**
40
411. 根据别名确认该关键资产是否已经写入过或已经删除。
422. 重新写入关键资产,再访问该关键资产。
43
44## 24000003 关键资产已存在
45
46**错误信息**
47
48The asset already exists.
49
50**可能原因**
51
52已存在同别名(asset.Tag.ALIAS相同)的关键资产。
53
54**处理步骤**
55
56请先确认写入同别名的关键资产是否符合预期,如果不符合需排查别名是否错误,如果符合则可通过以下任意一种方式处理:
57
581. 先调用[asset.remove](js-apis-asset.md#assetremove)删除同别名的关键资产,再调用[asset.add](js-apis-asset.md#assetadd)重新写入。
592. 调用[asset.add](js-apis-asset.md#assetadd)时,指定参数asset.Tag.CONFLICT_RESOLUTION的值为asset.ConflictResolution.OVERWRITE60
61## 24000004 拒绝访问关键资产
62
63**错误信息**
64
65Access denied.
66
67**可能原因**
68
691. 在访问需要用户认证的关键资产前,用户认证失败。
70
712. 挑战值与授权令牌不匹配。
72
73**处理步骤**
74
751. 用户在访问需要用户认证的关键资产前,先进行用户认证。
76
772. 传递匹配的挑战值与授权令牌。
78
79## 24000005 锁屏状态不匹配
80
81**错误信息**
82
83The screen lock status does not match.
84
85**可能原因**
86
871. 在设备处于未设置锁屏密码的状态下,访问仅设置密码才允许访问的关键资产。
882. 在设备未完成首次解锁的状态下,访问仅首次解锁后才允许访问的关键资产。
893. 在设备未处于解锁状态下,访问仅解锁时才允许访问的关键资产。
90
91**处理步骤**
92
93设置锁屏密码或解锁后,再访问关键资产。
94
95## 24000006 系统内存不足
96
97**错误信息**
98
99Insufficient memory.
100
101**可能原因**
102
103系统内存不足。
104
105**处理步骤**
106
107关闭已打开的其他应用,重新发起处理请求。
108
109## 24000007 关键资产损坏
110
111**错误信息**
112
113The asset is corrupted.
114
115**可能原因**
116
117因设备掉电或存储系统异常导致的关键资产文件损坏。
118
119**处理步骤**
120
121恢复出厂设置。
122
123## 24000008 数据库操作失败
124
125**错误信息**
126
127The database operation failed.
128
129**可能原因**
130
1311. 用户尚未调用过add接口,进行asset数据库的创建,此时数据库还没创建出来,直接查询,会有该报错。
1322. 数据库访问异常。
133
134**处理步骤**
135
1361. 用户先调用add接口,将asset数据库创建出来之后再进行查询。
1372. 查看错误信息,排查数据库异常原因。
138
139## 24000009 算法库操作失败
140
141**错误信息**
142
143The cryptography operation failed.
144
145**可能原因**
146
147密码算法操作失败。
148
149**处理步骤**
150
151查看错误信息,排查算法库异常原因。
152
153## 24000010 进程通信错误
154
155**错误信息**
156
157IPC failed.
158
159**可能原因**
160
161进程通信错误。
162
163**处理步骤**
164
165查看错误信息,排查IPC通信异常原因。
166
167## 24000011 包管理服务异常
168
169**错误信息**
170
171Calling the Bundle Manager service failed.
172
173**可能原因**
174
175包管理服务异常。
176
177**处理步骤**
178
179查看错误信息,排查包管理服务异常原因。
180
181## 24000012 账号系统异常
182
183**错误信息**
184
185Calling the OS Account service failed.
186
187**可能原因**
188
189账号系统异常。
190
191**处理步骤**
192
193查看错误信息,排查账号系统异常原因。
194
195## 24000013 访问控制服务异常
196
197**错误信息**
198
199Calling the Access Token service failed.
200
201**可能原因**
202
203访问控制服务异常。
204
205**处理步骤**
206
207查看错误信息,排查访问控制服务异常原因。
208
209## 24000014 文件操作失败
210
211**错误信息**
212
213The file operation failed.
214
215**可能原因**
216
2171. 业务手动删除了设备中data/service/el1/public/asset_service某一级目录。
2182. 文件系统损坏。
219
220**处理步骤**
221
222重启设备,若仍未解决,请恢复出厂设置。
223
224## 24000015 获取系统时间失败
225
226**错误信息**
227
228Getting the system time failed.
229
230**可能原因**
231
232系统时间被篡改。
233
234**处理步骤**
235
236调整成正确的系统时间。
237
238## 24000016 缓存数量超限
239
240**错误信息**
241
242The cache exceeds the limit.
243
244**可能原因**
245
246业务调用[asset.preQuery](js-apis-asset.md#assetprequery)预查询后,没有通过[asset.postQuery](js-apis-asset.md#assetpostquery)释放资源。
247
248**处理步骤**
249
250业务调用[asset.preQuery](js-apis-asset.md#assetprequery)预查询后,通过[asset.postQuery](js-apis-asset.md#assetpostquery)释放资源。
251
252## 24000017 该子功能不支持
253
254**错误信息**
255
256The capability is not supported.
257
258**可能原因**
259
260支持API,但是不支持API内部某些子特性(功能),如批量查询关键资产明文。
261
262**处理步骤**
263
264调整API参数,使用可替代的调用方式,如多次调用API查询关键资产。
265
266## 24000018 参数校验失败
267
268**错误信息**
269
270Parameter verify failed.
271
272**可能原因**
273
274传入的参数不合法。
275
276**处理步骤**
277
278根据错误信息,调整API参数,并重新调用接口。