# 关键资产存储服务错误码

> phone | 2in1 | tablet | tv | wearable

> 说明
>
> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。

## 24000001 关键资产服务不可用

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The ASSET service is unavailable.

**错误描述**

关键资产服务不可用。

**可能原因**

系统异常导致关键资产服务不可用。

**处理步骤**

重新发起关键资产处理请求。

## 24000002 未找到关键资产

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The asset is not found.

**错误描述**

未找到关键资产。

**可能原因**

1. 关键资产从未写入过。
2. 关键资产已经删除。

**处理步骤**

1. 根据别名确认该关键资产是否已经写入过或已经删除。
2. 重新写入关键资产，再访问该关键资产。

## 24000003 关键资产已存在

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The asset already exists.

**错误描述**

关键资产已存在。

**可能原因**

已存在同别名（asset.Tag.ALIAS相同）的关键资产。

**处理步骤**

请先确认写入同别名的关键资产是否符合预期，如果不符合需排查别名是否错误，如果符合则可通过以下任意一种方式处理：

1. 先调用[asset.remove](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetremove)删除同别名的关键资产，再调用[asset.add](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetadd)重新写入。
2. 调用[asset.add](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetadd)时，指定参数asset.Tag.CONFLICT_RESOLUTION的值为asset.ConflictResolution.OVERWRITE。

## 24000004 访问被拒绝

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Access denied.

**错误描述**

访问关键资产被拒绝。

**可能原因**

1. 在访问需要用户认证的关键资产前，用户认证失败。

2. 挑战值与授权令牌不匹配。

**处理步骤**

1. 用户在访问需要用户认证的关键资产前，先进行用户认证。

2. 传递匹配的挑战值与授权令牌。

## 24000005 锁屏状态不匹配

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The screen lock status does not match.

**错误描述**

设备锁屏状态与关键资产访问控制要求不匹配。

**可能原因**

1. 在设备处于未设置锁屏密码的状态下，访问仅设置密码才允许访问的关键资产。
2. 在设备未完成首次解锁的状态下，访问仅首次解锁后才允许访问的关键资产。
3. 在设备未处于解锁状态下，访问仅解锁时才允许访问的关键资产。

**处理步骤**

设置锁屏密码或解锁后，再访问关键资产。

## 24000006 系统内存不足

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Insufficient memory.

**错误描述**

系统内存不足。

**可能原因**

系统内存不足。

**处理步骤**

关闭已打开的其他应用，重新发起处理请求。

## 24000007 关键资产损坏

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The asset is corrupted.

**错误描述**

关键资产损坏。

**可能原因**

因设备掉电或存储系统异常导致的关键资产文件损坏。

**处理步骤**

恢复出厂设置。

## 24000008 数据库操作失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The database operation failed.

**错误描述**

操作关键资产数据库失败。

**可能原因**

1. 用户尚未调用过add接口，进行asset数据库的创建，此时数据库还没创建出来，直接查询，会有该报错。
2. 数据库访问异常。

**处理步骤**

1. 用户先调用add接口，将asset数据库创建出来之后再进行查询。
2. 查看错误信息，排查数据库异常原因。

## 24000009 算法库操作失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The cryptography operation failed.

**错误描述**

密码算法操作失败。

**可能原因**

密码算法操作失败。

**处理步骤**

查看错误信息，排查算法库异常原因。

## 24000010 进程通信错误

> phone | 2in1 | tablet | tv | wearable

**错误信息**

IPC failed.

**错误描述**

IPC通信失败。

**可能原因**

进程通信错误。

**处理步骤**

查看错误信息，排查IPC通信异常原因。

## 24000011 包管理服务异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Calling the Bundle Manager service failed.

**错误描述**

调用包管理服务失败。

**可能原因**

包管理服务异常。

**处理步骤**

查看错误信息，排查包管理服务异常原因。

## 24000012 账号系统服务异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Calling the OS Account service failed.

**错误描述**

调用账号系统服务失败。

**可能原因**

账号系统异常。

**处理步骤**

查看错误信息，排查账号系统异常原因。

## 24000013 访问控制服务异常

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Calling the Access Token service failed.

**错误描述**

调用访问控制服务失败。

**可能原因**

访问控制服务异常。

**处理步骤**

查看错误信息，排查访问控制服务异常原因。

## 24000014 文件操作失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The file operation failed.

**错误描述**

文件操作失败。

**可能原因**

1. 业务手动删除了设备中data/service/el1/public/asset_service某一级目录。
2. 文件系统损坏。

**处理步骤**

重启设备，若仍未解决，请恢复出厂设置。

## 24000015 获取系统时间失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Getting the system time failed.

**错误描述**

获取系统时间失败。

**可能原因**

系统时间被篡改。

**处理步骤**

调整成正确的系统时间。

## 24000016 缓存数量超限

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The cache exceeds the limit.

**错误描述**

关键资产预查询缓存数量超限。

**可能原因**

业务调用[asset.preQuery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetprequery)预查询后，没有通过[asset.postQuery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetpostquery)释放资源。

**处理步骤**

业务调用[asset.preQuery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetprequery)预查询后，通过[asset.postQuery](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#assetpostquery)释放资源。

## 24000017 该子功能不支持

> phone | 2in1 | tablet | tv | wearable

**错误信息**

The capability is not supported.

**错误描述**

该子功能不支持。

**可能原因**

支持API，但是不支持API内部某些子特性（功能），如批量查询关键资产明文。

**处理步骤**

调整API参数，使用可替代的调用方式，如多次调用API查询关键资产。

## 24000018 参数校验失败

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Parameter verify failed.

**错误描述**

参数校验失败。

**可能原因**

传入的参数不合法。

**处理步骤**

根据错误信息，调整API参数，并重新调用接口。

## 24000019 属性值不一致

> phone | 2in1 | tablet | tv | wearable

**错误信息**

Each value of [Tag.GROUP_ID](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#tag) and [Tag.REQUIRE_ATTR_ENCRYPTED](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-asset#tag) in the array is not consistent.

**错误描述**

批量操作时，数组中关键资产的GROUP_ID和REQUIRE_ATTR_ENCRYPTED属性值不一致。

**可能原因**

批量操作时，数组中每个关键资产的GROUP_ID和REQUIRE_ATTR_ENCRYPTED属性值不一致。

**处理步骤**

确保批量操作数组中所有关键资产的GROUP_ID和REQUIRE_ATTR_ENCRYPTED属性值一致，然后重新调用接口。