大网数据广告活动
OpenHarmony 设备与应用开发

关键资产存储服务错误码

· 52CE 我爱测

# 关键资产存储服务错误码 > **说明:** > > 以下仅介绍本模块特有错误码,通用错误码请参考通用错误码说明文档。 ## 24000001 关键资产服务不可用 **错误信息** The ASSET service is unavailable. **可能原因** 系统异常导致关键资产服务不可用。 **处理步骤** 重新发起关键资产处理请求。 ## 24000002 未找到关键资产 **错误信息** The asset is not

关键资产存储服务错误码

说明:

以下仅介绍本模块特有错误码,通用错误码请参考通用错误码说明文档。

24000001 关键资产服务不可用

错误信息

The ASSET service is unavailable.

可能原因

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

处理步骤

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

24000002 未找到关键资产

错误信息

The asset is not found.

可能原因

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

处理步骤

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

24000003 关键资产已存在

错误信息

The asset already exists.

可能原因

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

处理步骤

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

  1. 先调用asset.remove删除同别名的关键资产,再调用asset.add重新写入。
  2. 调用asset.add时,指定参数asset.Tag.CONFLICT_RESOLUTION的值为asset.ConflictResolution.OVERWRITE。

24000004 访问被拒绝

错误信息

Access denied.

可能原因

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

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

处理步骤

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

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

24000005 锁屏状态不匹配

错误信息

The screen lock status does not match.

可能原因

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

处理步骤

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

24000006 系统内存不足

错误信息

Insufficient memory.

可能原因

系统内存不足。

处理步骤

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

24000007 关键资产损坏

错误信息

The asset is corrupted.

可能原因

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

处理步骤

恢复出厂设置。

24000008 数据库操作失败

错误信息

The database operation failed.

可能原因

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

处理步骤

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

24000009 算法库操作失败

错误信息

The cryptography operation failed.

可能原因

密码算法操作失败。

处理步骤

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

24000010 进程通信错误

错误信息

IPC failed.

可能原因

进程通信错误。

处理步骤

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

24000011 包管理服务异常

错误信息

Calling the Bundle Manager service failed.

可能原因

包管理服务异常。

处理步骤

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

24000012 账号系统服务异常

错误信息

Calling the OS Account service failed.

可能原因

账号系统异常。

处理步骤

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

24000013 访问控制服务异常

错误信息

Calling the Access Token service failed.

可能原因

访问控制服务异常。

处理步骤

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

24000014 文件操作失败

错误信息

The file operation failed.

可能原因

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

处理步骤

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

24000015 获取系统时间失败

错误信息

Getting the system time failed.

可能原因

系统时间被篡改。

处理步骤

调整成正确的系统时间。

24000016 缓存数量超限

错误信息

The cache exceeds the limit.

可能原因

业务调用asset.preQuery预查询后,没有通过asset.postQuery释放资源。

处理步骤

业务调用asset.preQuery预查询后,通过asset.postQuery释放资源。

24000017 该子功能不支持

错误信息

The capability is not supported.

可能原因

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

处理步骤

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

24000018 参数校验失败

错误信息

Parameter verify failed.

可能原因

传入的参数不合法。

处理步骤

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

24000019 属性值不一致

错误信息

Each value of Tag.GROUP_ID and Tag.REQUIRE_ATTR_ENCRYPTED in the array is not consistent.

可能原因

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

处理步骤

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

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。