目录

ArkTS API错误码

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

1028700001 参数不合法

错误信息

Invalid argument.

错误简述

参数不合法。

错误描述

该错误可能在如下位置产生:

  1. runApp方法抛出此错误,表示传入的数据应用路径不合法,或者找不到该数据应用文件。

  2. sendData方法抛出此错误,表示该句柄不合法。

可能原因

  1. runApp方法抛出此错误,可能是:

    1. 数据应用文件未包含在HAP包中。

    2. 该接口调用参数中的文件路径不正确(当前本接口仅支持从应用沙箱目录中加载文件)。

  2. sendData方法抛出此错误,可能是已经调用过stop方法,导致该句柄已被回收。

处理步骤

  1. 若runApp抛出此错误,请确认数据应用程序文件已打包进HAP中,并且runApp传入路径是以/data/storage/el1/bundle/开头的应用沙箱内部绝对路径(如/data/storage/el1/bundle/libs/arm64/libda_demo.so)。

  2. 若sendData方法抛出此错误,请避免复用已经调用过stop的数据应用句柄。

1028700002 数据应用签名文件不存在

错误信息

Signature file does not exist.

错误描述

签名文件不存在。

可能原因

数据应用签名文件未包含在HAP包中。

处理步骤

请确认签名文件已正确生成并打包进HAP中,放置在数据应用文件相同目录,并且文件名称为该数据应用文件完整名称 + .sig。

1028700003 启动机密空间失败

错误信息

Failed to start the confidential space.

错误描述

启动机密空间失败。

可能原因

由于系统内部原因无法启动机密空间。

处理步骤

请优先重试或者重启设备重试。若重试不成功,请通过在线提单申请帮助。

1028700004 数据应用启动失败

错误信息

Failed to start the data app.

错误描述

启动数据应用失败。

可能原因

由于系统内部原因无法启动数据应用。

处理步骤

请优先重试或者重启设备重试。若重试不成功,请通过在线提单申请帮助。

1028700005 访问被拒绝

错误信息

Access permission denied.

错误描述

应用没有调用机密空间的权限。

可能原因

应用没有申请Kit的调用权限。

处理步骤

申请Kit的调用权限。

1028700006 已达到调用次数上限

错误信息

Call limit reached.

错误描述

已达到调用次数上限。

可能原因

runApp接口调用次数已达到限制,该接口的调用规格限制请参见在机密空间中运行数据应用 - 约束与限制。

处理步骤

减少每日的接口调用次数。

1028700007 操作超时

错误信息

Operation timed out.

错误描述

操作超时。

可能原因

由于系统内部原因无法启动机密空间管理服务,导致应用连接服务超时。

处理步骤

请优先重试或者重启设备重试。若重试不成功,请通过在线提单申请帮助。

1028700008 数据应用已停止运行

错误信息

The data app has stopped running.

错误描述

该数据应用已停止运行。

可能原因

该数据应用已经自行退出,或者数据应用发生崩溃异常退出,或者该数据应用因为执行超时被机密空间强行中止。

处理步骤

  1. 缩短机密空间的交互时间窗口,在数据应用启动后尽快完成通信。

  2. 调试数据应用,避免应用的异常退出。

1028700009 应用与数据管理服务间通信失败

错误信息

Communication between client and data manager failed.

错误描述

应用与数据管理服务间通信失败。

可能原因

  1. runApp方法抛出此错误,表明应用与机密空间管理服务之间的通信失败。

  2. sendData方法抛出此错误,表明由于应用与数据管理服务间通信的socket发生异常,导致通信无法进行。

处理步骤

  1. 若runApp抛出此错误,请尝试重试。

  2. 若sendData抛出此错误,请避免过于高频地发送数据。

1028700010 数据管理服务与数据应用间通信失败

错误信息

Communication between data manager and data app failed.

错误描述

数据管理服务与数据应用间通信失败。

可能原因

由于数据管理服务与数据应用通信的socket发生异常,导致应用发送到数据管理服务的数据无法进行转发。

处理步骤

调试数据应用,避免socket出现异常。

1028700011 消息过长

错误信息

Message exceeded size limit.

错误描述

消息过长。

可能原因

  1. sendData方法抛出此错误,表示传入的数据过长。

  2. onReceiveDataError方法注册的回调接收到此类型错误,表示数据应用侧发送的消息过长,无法被应用接收。

处理步骤

将单次通信长度控制在16MB以内。如果不得不发送此规格以上的数据,请拆分为多次发送或接收。

1028700012 配置文件包含非法配置项

错误信息

The profile contains invalid configuration items.

错误描述

配置文件包含非法配置项。

可能原因

数据应用的配置文件包含非法的配置项。

处理步骤

检查数据应用的配置文件是否已正确。

1028700013 接收的数据签名失败

错误信息

Failed to sign data received from data app.

错误描述

无法对从数据应用接收的数据进行签名。

可能原因

由于内部原因,获取设备证书失败,导致无法对从空间内部发出的数据进行签名。

处理步骤

请在联网条件下重试。

1028700014 数据应用错误

错误信息

Error generated by the data app.

错误描述

由数据应用产生的错误。

可能原因

由数据应用自行产生的业务层面错误。

处理步骤

数据应用产生的原始错误码包含在DataAppErrorInfo的dataAppErrorCode属性中。开发者可以在onReceiveDataError注册的回调函数中捕获此类错误并获取数据应用原始错误码。

例如,若所注册回调函数参数列表为(e: BusinessError<DataAppErrorInfo>),则可在ArkTS代码中通过e.data?.dataAppErrorCode获取数据应用原始错误码。

1028700015 应用侧内部错误

错误信息

Internal error on the client side.

错误描述

应用侧内部错误。

可能原因

由于应用侧内部错误,无法连接机密空间管理服务。

处理步骤

请优先重试或者重启应用重试,再重启设备重试。若重试不成功,请通过在线提单申请帮助。

1028700016 机密空间管理服务内部错误

错误信息

Internal error on the confidential space manager side.

错误描述

机密空间管理服务内部错误。

可能原因

由于机密空间管理服务内部错误,无法连接机密空间管理服务。

处理步骤

请优先重试或者重启设备重试。若重试不成功,请通过在线提单申请帮助。

1028700017 签名文件的证书无效

错误信息

Invalid certificate of the signature file.

错误描述

签名文件的证书无效。

可能原因

签名文件中所含证书链未通过校验,比如证书链的根不是机密空间根证书,证书链上下级之间不匹配等。

处理步骤

检查签名数据应用时的证书链文件,确保根证书是机密空间根证书,并且证书链可以通过校验。

1028700018 签名文件中包含的哈希值与数据应用的实际哈希值不匹配

错误信息

The hash contained in the signature file does not match the actual hash of the data app.

错误描述

签名文件中包含的哈希值与数据应用的实际哈希值不匹配。

可能原因

使用了错误的数据应用文件生成了签名文件,或者生成签名文件后数据应用文件的哈希值发生了变化。

处理步骤

检查签名数据应用时的数据应用文件,确保签名完成后数据应用文件哈希值无变化。

1028700019 签名文件格式不合法

错误信息

Invalid signature file format.

错误描述

签名文件格式不合法。

可能原因

签名文件格式损坏。

处理步骤

重新生成数据应用的签名文件。

1028700020 数据应用会话数超过上限

错误信息

The number of data app sessions exceeds the limit.

错误描述

数据应用会话数超过上限。

可能原因

每个应用最多同时开启一个会话,可能重复开启了会话,或者开启会话时上一个会话仍未关闭。

处理步骤

检查runApp调用逻辑,不要同时运行两个数据应用会话。

1028700021 数据应用数量超过上限

错误信息

The number of data apps exceeds the limit.

错误描述

数据应用数量超过上限。

可能原因

机密空间内部同时运行的数据应用已经达到上限。

处理步骤

请重试或者重启设备重试。

1028700022 数据应用中不包含入口或者入口无效

错误信息

The entry of the data app is missing or invalid.

错误描述

数据应用中不包含入口或者入口无效。

可能原因

没有识别到数据应用的程序入口,或者程序入口的配置无效。

处理步骤

数据应用中必须包含g_da_entry结构体,并且handler字段不为空。

1028700023 数据应用加载时动态库加载失败

错误信息

Failed to load dynamic library when loading the data app.

错误描述

数据应用加载时动态库加载失败。

可能原因

数据应用动态链接了机密空间内部不可用的库,或者依赖了未定义的符号。

处理步骤

避免依赖不可用的库,避免定义没有实现的符号。

1028700024 机密空间内存超过上限

错误信息

Confidential space memory exceeds limit.

错误描述

机密空间内存超过上限。

可能原因

当前运行的数据应用内存总量已经接近资源上限,机密空间拒绝运行新的数据应用,以尽量避免产生内存不足,导致机密空间内其他数据应用不可用。

处理步骤

请重试或者重启设备重试。

1028700025 当前设备没有调试授权

错误信息

The device is not authorized for debugging.

错误描述

当前设备没有调试授权。

可能原因

当前数据应用的配置文件为调试类型,但是没有将运行的本设备添加进授权设备列表。

处理步骤

修改配置文件,将本设备的udid添加进授权列表。

1028700026 配置文件不在有效期内

错误信息

The profile is not within its validity period.

错误描述

配置文件不在有效期内。

可能原因

在设备上运行的时间不在配置文件的有效期范围内。

处理步骤

修改配置文件的有效期配置,至少从当前时间开始,到未来预期能运行的时间范围末尾为止。

1028700027 无法解析配置文件

错误信息

Failed to parse profile.

错误描述

无法解析配置文件。

可能原因

配置文件格式不合法。

处理步骤

检查配置文件格式,重新获取签名的配置文件。

1028700028 配置文件验签失败

错误信息

Failed to verify the signature of the profile.

错误描述

配置文件验签失败。

可能原因

配置文件的签名与内嵌的证书不匹配。

处理步骤

重新获取合法签名的配置文件。

1028700029 配置文件的证书链无效

错误信息

The certificate chain in the profile is invalid.

错误描述

配置文件的证书链无效。

可能原因

配置文件的证书链未通过校验,比如证书链的根不是机密空间根证书,证书链上下级之间不匹配等。

处理步骤

检查签名配置文件时的证书链文件,确保根证书是机密空间根证书,并且证书链可以通过校验,再重新获取合法签名的配置文件。

1028700030 签名文件验签失败

错误信息

Failed to verify the signature of the signature file.

错误描述

签名文件验签失败。

可能原因

签名文件所含签名值与内嵌的数据应用证书不匹配。

处理步骤

重新生成数据应用签名文件,避免签名文件遭到篡改。