元能力子系统错误码
说明:
当前为Beta阶段。
说明:
以下仅介绍本模块特有错误码,通用错误码请参考通用错误码说明文档。
16000001 指定的Ability名称不存在
错误信息
The specified ability does not exist.
错误描述
当指定的Ability名称不存在时,方法将返回该错误码。
可能原因
所查询的Ability不存在。
处理步骤
- 检查Want中的bundleName、moduleName和abilityName是否正确。
- 检查传入Want中bundleName对应的应用是否安装。可使用如下命令查询已安装的应用列表,若bundleName不在查询结果中,说明应用未安装成功。
hdc shell bm dump -a - 多hap应用需确认ability所属的hap是否已被安装。可使用如下命令查询应用的包信息,若安装的应用中没有对应的hap和ability,说明ability所属的hap未被安装。
hdc shell bm dump -n 包名
16000002 接口调用Ability类型错误
错误信息
Incorrect ability type.
错误描述
当调用Ability相关接口时,被调用方的Ability类型与接口期望的类型不匹配。
可能原因
- 被调用方(服务端)的Ability类型与调用方(客户端)接口期望的类型不匹配。
- 当目标服务端为AppServiceExtensionAbility类型时,未在module.json5配置文件中配置ACL权限(ohos.permission.SUPPORT_APP_SERVICE_EXTENSION)。
处理步骤
- 检查Want中的bundleName、moduleName和abilityName是否正确。
- 确认被调用方(服务端)的Ability类型与调用接口是否匹配。
16000003 指定的ID不存在
错误信息
The specified ID does not exist.
错误描述
当指定的ID不存在时,方法将返回该错误码。
可能原因
操作的目标ID不存在。
处理步骤
确认操作的ID是否存在。
16000004 可见性校验失败
错误信息
Cannot start an invisible component.
错误描述
当可见性校验失败时,方法将返回该错误码。
可能原因
应用可见性校验失败。
处理步骤
- Stage模型下,拉起应用时抛出16000004异常,表示被拉应用调用失败,需要检查被拉应用module.json5的Ability字段的exported配置是否为true。该配置字段为true,表示可以被其他应用调用;该配置字段为false,表示不可以被其他应用调用。
- 若应用需要拉起exported为false的ability,请申请ohos.permission.START_INVISIBLE_ABILITY权限(该权限仅系统应用可申请)。
16000005 指定的进程权限校验失败
错误信息
The specified process does not have the permission.
错误描述
当指定的进程权限校验失败时,方法将返回该错误码。
可能原因
指定的进程权限校验失败。
处理步骤
确认调用方是否有目标组件要求的权限。
16000006 不允许跨用户操作
错误信息
Cross-user operations are not allowed.
错误描述
当应用跨用户操作时,方法将返回该错误码。
可能原因
应用进行了跨用户操作。
处理步骤
确认是否进行了跨用户操作,检查接口调用时传入的userID是否与当前userID一致。
16000007 服务未响应
错误信息
Service busy. There are concurrent tasks. Try again later.
错误描述
当系统服务未响应时,方法将返回该错误码。
可能原因
应用在系统服务未启动时访问系统服务。
处理步骤
请等待系统服务启动后重试原操作。
16000008 众测应用到期
错误信息
The crowdtesting application expires.
错误描述
当众测应用到期时,方法将返回该错误码。
可能原因
众测应用到期,无法打开。
处理步骤
请检查应用是否众测到期,已过有效期的众测应用无法启动。
16000009 wukong模式,不允许启动/停止ability
错误信息
An ability cannot be started or stopped in Wukong mode.
错误描述
当wukong模式下,启动/停止ability时,方法将返回该错误码。
可能原因
wukong模式,不允许启动/停止ability。
处理步骤
退出wukong模式后,再尝试启动/停止ability。请勿在wukong模式下启动/停止Ability。
16000010 不允许带迁移flag
错误信息
The call with the continuation and prepare continuation flag is forbidden.
错误描述
当调用携带迁移flag时,方法将返回该错误码。
可能原因
当前调用不允许携带迁移flag。
处理步骤
请检查是否携带迁移flag。
16000011 上下文对象不存在
错误信息
The context does not exist.
错误描述
当上下文对象不存在时,方法将返回该错误码。
可能原因
当前上下文对象不存在。
处理步骤
请检查上下文对象是否可用。
16000012 应用被管控
错误信息
The application is controlled.
错误描述
当应用受到管控时,将返回该错误码。
可能原因
应用被系统管控模块管控,不允许启动。
处理步骤
目标应用被系统管控禁止拉起,请稍后再尝试调用。
16000013 应用被EDM管控
错误信息
The application is controlled by EDM.
错误描述
当应用受到企业设备管理Enterprise Device Manager管控时,方法将返回该错误码。
可能原因
应用受企业设备管理管控。
处理步骤
请联系企业设备管理相关人员。
16000015 服务超时
错误信息
Service timeout.
错误描述
当服务超时时,方法将返回该错误码。
可能原因
服务超时。
处理步骤
服务超时,请稍后重试。
16000017 上一个Ability未启动完成,先缓存在队列中等待后续启动
错误信息
Another ability is being started. Wait until it finishes starting.
错误描述
由于系统处理能力有限,当需要启动的Ability过多时,会先将请求缓存在队列中,按照顺序依次处理。
可能原因
系统并发请求量过大。
处理步骤
无需处理,等待启动即可。
16000018 限制API 11以上版本三方应用跳转
错误信息
Redirection to a third-party application is not allowed in API version greater than 11.
错误描述
当应用API版本大于11的时候,不允许显式跳转到其他三方应用。
可能原因
应用使用的API版本大于11并且显式跳转到其他三方应用。
处理步骤
使用隐式启动方式或通过openLink跳转其他应用。
16000019 隐式启动未查找到匹配应用
错误信息
No matching ability is found.
错误描述
隐式启动无法查找到匹配的Ability。
可能原因
- 隐式启动的参数配置有误。
- 指定的HAP包未安装。
处理步骤
- 确保隐式启动的参数配置正确,匹配规则详见显式Want与隐式Want匹配规则。
- 确保对应的HAP包已安装。
16000050 内部错误
错误信息
Internal error.
错误描述
当出现了开发者无法解决的内部异常错误(如内存申请失败、多线程处理异常、跨进程通信失败等)时,方法将返回该错误码。
可能原因
- 启动Ability时传入的Want数据过大。
- 设备解锁前拉起非系统应用。
- 隐式拉起时未安装应用市场App。
- 开发者无法处理的系统内部错误。包括但不限于:内部对象为空指针、处理超时、IPC跨进程通信失败、包管理获取应用信息失败、系统服务获取失败、启动的Ability实例已达到上限等。
处理步骤
- 对于启动Ability失败时,可以检查传入的Want数据是否过大。
- 确保在设备解锁前只拉起系统应用,或者延迟拉起非系统应用直到设备解锁。
- 确保设备上已安装应用市场App,或者在拉起应用前检查应用市场App是否已安装。
- 对于开发者无法处理的系统内部错误,请尝试重新调用该接口,或者重启设备。
16000051 网络异常
错误信息
Network error.
错误描述
当网络异常时,该错误码将被返回。
可能原因
网络不可用。
处理步骤
网络异常,请稍后重试或重新连接网络。
16000052 不支持免安装
错误信息
Installation-free is not supported.
错误描述
当前应用不支持免安装时,该错误码将被返回。
可能原因
应用包不满足免安装要求,如包大小超过限制等。
处理步骤
请检查应用是否支持免安装。
16000053 非顶层应用
错误信息
The ability is not on the top of the UI.
错误描述
当前应用未显示在界面顶层时,方法将返回该错误码。
可能原因
用户执行免安装启动时需要确保应用在前台,但应用未显示在界面顶层。
处理步骤
- 请确保当前应用已启动并处于前台运行状态。
- 请核实应用界面是否完全显示,且未被其他应用窗口遮挡或最小化。
- 如设备启用了分屏或多窗口模式,请确保当前应用为焦点窗口。
16000054 免安装服务繁忙
错误信息
The installation-free service is busy. Try again later.
错误描述
当免安装服务繁忙时,该错误码将被返回。
可能原因
已有相同原子化服务的下载安装任务在执行。
处理步骤
免安装服务繁忙,请稍后重试。
16000055 免安装超时
错误信息
Installation-free timed out.
错误描述
当免安装超时时,方法将返回该错误码。
可能原因
免安装超时。
处理步骤
免安装超时,请稍后重试。
16000061 不支持的操作
错误信息
Operation not supported.
错误描述
当操作在当前系统上不支持时,返回该错误码。
可能原因
操作在当前系统上不支持。
处理步骤
确认操作在当前系统版本上是否支持。
16000062 子进程数量超出上限
错误信息
The number of child processes exceeds the upper limit.
错误描述
当申请创建子进程时,创建的子进程数量已经达到上限,返回该错误码。
可能原因
创建的子进程数量已经达到上限。
处理步骤
确认创建的子进程数量是否已经达到上限。子进程数量上限为512个。
16000063 重启应用指定组件无效
错误信息
The target to restart does not belong to the current application or is not a UIAbility.
错误描述
当重启应用拉起指定组件时,指定组件名称或类型无效,返回该错误码。
可能原因
指定组件名称或类型无效。
处理步骤
确认指定组件名称为当前应用组件,且类型为UIAbility。
16000064 重启应用频繁
错误信息
Restart too frequently. Try again at least 3s later.
错误描述
当重启应用拉起指定组件时,3s内再次调用,返回该错误码。
可能原因
调用接口频繁。
处理步骤
请等待至少3s后再次尝试重启操作。
16000065 接口只支持Ability在前台时调用
错误信息
The API can be called only when the ability is running in the foreground.
错误描述
当Ability不在前台时,方法将返回该错误码。
可能原因
调用接口时,Ability不在前台。
处理步骤
在调用接口前,请确保当前Ability已处于前台运行且界面可见状态。
16000066 wukong模式,不允许移动Ability到前台/后台
错误信息
An ability cannot switch to the foreground or background in Wukong mode.
错误描述
当wukong模式下,移动Ability到前台/后台时,方法将返回该错误码。
可能原因
wukong模式,不允许移动Ability到前台/后台。
处理步骤
退出wukong模式后,再尝试移动Ability到前台/后台。请勿在wukong模式下移动Ability到前台/后台。
16000067 Ability启动参数校验失败
错误信息
The StartOptions check failed.
错误描述
当StartOptions相关的参数校验失败时,返回该错误码。
可能原因
- 调用startAbility时,processMode设置为NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM或者ATTACH_TO_STATUS_BAR_ITEM,但是应用在状态栏没有图标,则返回该错误码。
- 调用showAbility/hideAbility时,如果调用方不是以NEW_PROCESS_ATTACH_TO_STATUS_BAR_ITEM或者ATTACH_TO_STATUS_BAR_ITEM模式启动,则返回该错误码。
处理步骤
确认StartOptions参数配置,以及相应的约束条件是否满足。
16000068 Ability已经在运行中
错误信息
The ability is already running.
错误描述
当目标Ability已经在运行中时,返回该错误码。
可能原因
调用startAbility时,指定了processMode和startupVisibility,目标Ability的launchType是singleton或者specified,并且目标Ability正在运行中,则返回该错误码。
处理步骤
当目标Ability的launchType是singleton或者specified时,避免通过指定processMode和startupVisibility的方式重复startAbility。
16000069 严格模式下不允许该类型Extension启动三方应用
错误信息
The extension cannot start the third party application.
错误描述
严格模式下,不允许该类型Extension启动三方应用。
可能原因
当前Extension处于严格模式,且对应的Extension类型不允许严格模式下启动其他三方应用。
处理步骤
- 查看对应Extension类型严格模式开启条件。
- 以非严格模式启动当前Extension。
16000070 严格模式下不允许该类型Extension启动指定ServiceExtensionAbility
错误信息
The extension cannot start the service.
错误描述
严格模式下,不允许该类型Extension启动指定ServiceExtensionAbility。
可能原因
当前Extension处于严格模式,且对应的Extension类型不允许严格模式下启动指定ServiceExtensionAbility。
处理步骤
- 查看对应Extension类型严格模式开启条件。
- 以非严格模式启动当前Extension。
16000071 不支持应用分身模式
错误信息
App clone is not supported.
错误描述
当应用不支持分身模式时,返回该错误码。
可能原因
该应用没有在app.json5配置文件multiAppMode标签中配置应用分身字段,导致该应用不支持分身模式,调用getCurrentAppCloneIndex接口时返回该错误码。
处理步骤
在app.json5配置文件中配置multiAppMode标签,开启应用分身功能后,再调用getCurrentAppCloneIndex口。
16000072 不支持应用多开
错误信息
App clone or multi-instance is not supported.
错误描述
当应用不支持多开时,返回该错误码。
可能原因
调用startAbility、startAbilityForResult等启动Ability接口时,如果目标应用不支持应用多开,则返回该错误码。
处理步骤
调用startAbility、startAbilityForResult等启动Ability接口时,确保目标应用支持应用多开,并在app.json5配置文件中配置multiAppMode标签开启应用分身功能。
16000073 传入的appCloneIndex是一个无效值
错误信息
The app clone index is invalid.
错误描述
传入一个无效的appCloneIndex,返回该错误码。
可能原因
-
调用startAbility时,使用ohos.extra.param.key.appCloneIndex携带的appCloneIndex是一个无效值,则返回该错误码。
-
调用isAppRunning时,入参appCloneIndex是一个无效值,则返回该错误码。
-
尝试连接不支持应用分身的ExtensionAbility时,返回该错误码。
处理步骤
确认appCloneIndex的约束条件是否满足。
16000074 返回结果时requestCode对应的调用方不存在
错误信息
The caller does not exist.
错误描述
通过backToCallerAbilityWithResult接口向调用方返回结果时,如果根据传入的requestCode无法找到调用方,返回该错误码。
可能原因
-
requestCode不是通过Want中的CALLER_REQUEST_CODE字段获取的。
-
requestCode对应的调用方已经被销毁或结果已经返回。
处理步骤
-
确认requestCode是否是通过Want中的CALLER_REQUEST_CODE获取的。
-
确认调用方是否被销毁或结果已经返回。
16000075 不支持返回结果时拉起调用方
错误信息
BackToCaller is not supported.
错误描述
不支持通过backToCallerAbilityWithResult接口返回到调用方时,返回该错误码。
可能原因
当前应用未进行linkFeature配置或未通过系统审核。
处理步骤
- 确认当前应用已在module.json5文件中配置linkFeature字段。
- 确认当前应用声明的linkFeature取值正确,linkFeature描述的功能与应用链接对应的实际功能一致,且应用通过系统审核。
16000076 指定的APP_INSTANCE_KEY不存在
错误信息
The app instance key is invalid.
错误描述
指定的APP_INSTANCE_KEY不存在时,返回该错误码。
可能原因
应用的实例中不存在该APP_INSTANCE_KEY指定的实例。
处理步骤
确保传入的APP_INSTANCE_KEY是一个有效值。
16000077 应用的实例数量已达到上限
错误信息
The number of app instances reaches the limit.
错误描述
当应用的实例数量达到上限后,继续创建应用实例,返回该错误码。
可能原因
创建应用实例前未判断应用实例数量是否已达到应用自己设置的上限值。
处理步骤
应用实例已达上限,如果必须要创建新的实例,可弹框提示用户删除已有实例。
16000078 不支持应用多实例
错误信息
The multi-instance is not supported.
错误描述
应用不支持多实例。
可能原因
- 目标应用未配置多实例。
- 当前设备类型不支持多实例。
处理步骤
- 对目标应用配置多实例。
- 在2in1设备上调用该方法。
16000079 不支持指定APP_INSTANCE_KEY
错误信息
The APP_INSTANCE_KEY cannot be specified.
错误描述
APP_INSTANCE_KEY和CREATE_APP_INSTANCE_KEY不支持同时指定。当指定CREATE_APP_INSTANCE_KEY的同时指定APP_INSTANCE_KEY,返回该错误码。
可能原因
参数传入过多。
处理步骤
参数APP_INSTANCE_KEY和CREATE_APP_INSTANCE_KEY只支持二选一。
16000080 不支持创建新实例
错误信息
Creating a new instance is not supported.
错误描述
只允许应用使用CREATE_APP_INSTANCE_KEY创建自己的实例,不允许应用间启动时为其他应用创建实例。否则,返回该错误码。
可能原因
参数使用场景有误。
处理步骤
删除参数CREATE_APP_INSTANCE_KEY。
16000082 单实例模式下的UIAbility未完成启动
错误信息
The UIAbility is being started.
错误描述
如果UIAbility启动模式为“singleton”,在UIAbility启动完成之前不能再次调用启动接口,否则将返回该错误码。
可能原因
该UIAbility为singleton模式,正在启动过程中。
处理步骤
确保该UIAbility启动完成,再执行新的启动任务。
16000083 不允许该类型ExtensionAbility启动指定Ability
错误信息
The ExtensionAbility cannot start the ability due to system control.
错误描述
不同类型ExtensionAbility所需要的能力不同。系统不允许该类型ExtensionAbility启动指定Ability。
可能原因
当前类型ExtensionAbility受系统管控,不允许该类型ExtensionAbility启动指定Ability。
处理步骤
查看对应类型ExtensionAbility的使用约束限制,确保接口使用符合约束限制。
16000084 只允许DelegatorAbility单次调用
错误信息
Only DelegatorAbility is allowed to call this API, and only once.
错误描述
系统只允许DelegatorAbility调用该接口一次。
可能原因
- 调用方不是DelegatorAbility。
- 调用方是DelegatorAbility,但是重复调用接口。
处理步骤
- 检查调用方是否DelegatorAbility。
- 检查是否重复调用。
16000085 元能力与窗口的交互流程发生错误
错误信息
An error occurred during the interaction between the ability and window.
错误描述
元能力与窗口的交互流程发生错误。
可能原因
窗口业务流程出现异常。
处理步骤
系统错误,尝试重新调用。
16000086 传入的context不是UIAbilityContext
错误信息
The context is not UIAbilityContext.
错误描述
传入的context不是UIAbilityContext。
可能原因
传入的Context对象既不是UIAbilityContext、也没有继承自UIAbilityContext。
处理步骤
请确保传入的参数为UIAbilityContext对象或其子类对象。
16000090 调用方不是原子化服务
错误信息
The caller is not an atomic service.
错误描述
调用方不是原子化服务。
可能原因
接口调用方不是原子化服务。
处理步骤
确认调用方是否为原子化服务。
16000100 监听Ability生命周期变化的AbilityMonitor方法执行失败
错误信息
Possible causes:
-
Calling AddAbilityMonitor failed.
-
Calling AddAbilityMonitorSync failed.
-
Calling RemoveAbilityMonitor failed.
-
Calling RemoveAbilityMonitorSync failed.
-
Calling WaitAbilityMonitor failed.
-
Calling GetCurrentTopAbility failed.
-
Calling DoAbilityForeground failed.
-
Calling DoAbilityBackground failed.
-
Calling FinishTest failed.
-
Calling AddAbilityStageMonitor failed.
-
Calling AddAbilityStageMonitorSync failed.
-
Calling RemoveAbilityStageMonitor failed.
-
Calling RemoveAbilityStageMonitorSync failed.
-
Calling WaitAbilityStageMonitor failed.
错误描述
当监听指定Ability的生命周期变化的AbilityMonitor方法执行失败时,返回该错误码。
可能原因
创建AbilityDelegatorRegistry实例执行失败。
处理步骤
检查是否成功创建了AbilityDelegatorRegistry实例。
16000101 执行shell命令失败
错误信息
Failed to run the shell command.
错误描述
当命令不是有效的shell命令时,该错误码将被返回。
可能原因
命令不是有效的shell命令。
处理步骤
检查命令是否为有效的shell命令。
16000110 当前应用不在Kiosk模式的列表内
错误信息
The current application is not in Kiosk app list and cannot enter Kiosk mode.
错误描述
当前应用不在Kiosk名单列表内,无法进入Kiosk模式。
可能原因
当前应用不在Kiosk名单列表,不支持该应用进入Kiosk模式。
处理步骤
需要EDM管控模块将当前应用添加到Kiosk应用列表内。
16000111 已经有应用进入了Kiosk模式
错误信息
The system is already in Kiosk mode and cannot enter Kiosk mode again.
错误描述
当前系统已处于Kiosk模式,无法再次进入。
可能原因
同一时间只允许一个应用进入Kiosk模式。
处理步骤
将已进入Kiosk模式的应用退出Kiosk模式。
16000112 当前系统没有应用进入Kiosk模式
错误信息
The current application is not in Kiosk mode and cannot exit Kiosk mode.
错误描述
当前应用未进入Kiosk模式,不能退出Kiosk模式。
可能原因
该应用进程之前未进入Kiosk模式,无法主动退出Kiosk模式。
处理步骤
检查当前系统是否有应用进入Kiosk模式。
16000113 当前Ability不在前台
错误信息
Current ability is not in foreground.
错误描述
当Ability未处于前台状态时,尝试执行需在前台进行的操作将返回错误码。
可能原因
当前Ability没有处于前台。
处理步骤
检查当前Ability是否处于前台状态。
16000130 UIAbility不属于调用方
错误信息
The UIAbility not belong to caller.
错误描述
目标UIAbility不属于调用方。
可能原因
启动了一个非自身应用的UIAbility。
处理步骤
检查目标UIAbility信息是否属于自身应用。
16000131 UIAbility已启动
错误信息
The UIAbility is already exist, can not start again.
错误描述
UIAbility已启动,无法重新启动。
可能原因
startSelfUIAbilityInCurrentProcess用于冷启动一个新的UIAbility实例,如果拉起一个已经启动过的UIAbility实例,报该异常。
处理步骤
检查UIAbility是否已启动过。
16000135 UIAbility的主窗不存在
错误信息
The main window of this ability of this context does not exits.
错误描述
该UIAbility的主窗不存在。
可能原因
Window还未创建或已销毁的时候调用该接口。
处理步骤
在windowStage创建前和销毁后不要调用该接口。
16000136 不允许通过App Linking方式拉起应用自身UIAbility
错误信息
The UIAbility is prohibited from launching itself via App Linking.
错误描述
应用配置了不允许使用App Linking拉起当前UIAbility。
可能原因
在module.json5配置文件的abilities标签中,当前UIAbility的allowSelfRedirect字段取值为“false”。
处理步骤
- 如果允许使用App Linking拉起当前UIAbility,开发者需要在module.json5配置文件将abilities标签的allowSelfRedirect字段设置为true。
- 如果不允许使用App Linking拉起当前UIAbility,开发者需要通过catch捕获该错误码并进行处理。
16000151 无效wantAgent对象
错误信息
Invalid wantAgent object.
错误描述
当传入接口的wantAgent对象无效时,方法将返回该错误码。
可能原因
- 传入接口的wantAgent对象无效。
- 三方应用设置其他应用的Ability。
- 其它内部通信错误。
处理步骤
- 检查传入接口的wantAgent对象是否存在。
- 检查调用方是否为三方应用。不支持三方应用设置其他应用的Ability。
16000200 不允许该调用方启动应用后台服务
错误信息
The caller is not in the appIdentifierAllowList of the target application.
错误描述
调用方不在目标应用的appIdentifierAllowList中时,返回该错误码。
可能原因
startAppServiceExtensionAbility、stopAppServiceExtensionAbility接口调用方的app-identifier不在目标AppServiceExtensionAbility的appIdentifierAllowList中。
处理步骤
将接口调用方的app-identifier配置在目标AppServiceExtensionAbility的appIdentifierAllowList中。
16000201 目标服务还未启动
错误信息
The target service has not been started yet.
错误描述
目标服务还未启动时,返回该错误码。
可能原因
使用connectAppServiceExtensionAbility接口时服务端还未启动且当前应用无权限拉起目标服务。
处理步骤
- 等待服务端启动后重新连接。
- 由当前应用拉起目标服务时,需要将接口调用方的app-identifier配置在目标AppServiceExtensionAbility的appIdentifierAllowList中。
16000115 当前进程不支持设置为备选主控进程
错误信息
The current process cannot be set as a candidate master process.
错误描述
当前进程不支持设置为备选主控进程。
可能原因
当前进程不满足以下任一条件:
- 运行了isolationProcess字段设为true的组件。
- 曾经成为过主控进程。
处理步骤
不支持处理。当前进程只有运行了isolationProcess字段设为true的组件,或曾为主控进程,才可设置为备选主控进程。
16000116 当前进程已经是主控进程
错误信息
The current process is already a master process and does not support cancellation.
错误描述
当前进程已经是主控进程,不支持取消备选主控进程。
可能原因
当前进程已经是主控进程,不支持取消备选主控进程。
处理步骤
不支持处理,当前进程已经是主控进程的情况下,不支持取消。
16000117 当前进程非备选主控进程
错误信息
The current process is not a candidate master process and does not support cancellation.
错误描述
当前进程不是备选主控进程,不支持取消。
可能原因
当前进程不是备选主控进程,不支持取消。
处理步骤
不支持处理,当前进程不是备选主控进程,不支持取消。
16000118 当前进程非主控进程
错误信息
Not a master process.
错误描述
当前进程不是主控进程。
可能原因
当前进程不是主控进程,无法放弃当前进程的主控进程身份。
处理步骤
不支持处理,当前进程不是主控进程,无法放弃其主控进程身份。
16000119 存在未完成的请求
错误信息
Cannot exit because there is an unfinished request.
错误描述
因为存在未完成的请求,放弃当前进程的主控进程身份失败。
可能原因
当前进程存在未完成的请求:
- 进程中存在未完成的onNewProcessRequest请求。
- 当启动模式为specified的UIAbility运行在独立进程时,当前进程中存在未完成的onAcceptWant请求。
处理步骤
等待当前进程中的请求完成,然后再放弃当前进程的主控进程身份。
16000205 当前接口未在主线程中调用
错误信息
The API is not called in the main thread.
错误描述
当前接口未在主线程调用。
可能原因
当前接口在worker或taskpool中调用,不支持该操作。
处理步骤
请将接口调用逻辑迁移到主线程中执行。
16100001 指定Uri的Ability不存在
错误信息
The ability with the specified URI does not exist.
错误描述
当指定Uri的Ability不存在时,该错误码将被返回。
可能原因
所查询的Ability不存在。
处理步骤
确认查询的Ability是否存在。
16100002 接口调用Ability类型错误
错误信息
Incorrect ability type.
错误描述
当接口调用Ability类型错误时,该错误码将被返回。
可能原因
接口调用所在的Ability类型不支持该接口调用。
处理步骤
- 检查包名对应的Ability是否正确。
- 根据Ability类型调用不同接口。
16200001 通用组件客户端(Caller)已回收
错误信息
The caller has been released.
错误描述
当通用组件客户端(Caller)已回收时,方法将返回该错误码。
可能原因
通用组件客户端(Caller)已回收。
处理步骤
- 重新创建有效的通用组件客户端(Caller)实例。
- 检查调用context.startAbility时,context对应的ability是否还在运行。若该ability已被析构,会抛出该错误码。
- 若存在连续调用startAbility和terminateSelf的情况,请确保在收到startAbility成功或失败的回调后,再调用terminateSelf。
16200002 通用组件服务端(Callee)无效
错误信息
The callee does not exist.
错误描述
当通用组件服务端(Callee)无效时,方法将返回该错误码。
可能原因
通用组件服务端(Callee)不存在。
处理步骤
请检查通用组件服务端(Callee)是否存在。
16200003 回收失败
错误信息
Release error. The caller does not call any callee.
错误描述
当回收失败时,该错误码将被返回。
可能原因
通用组件客户端(Caller)对象未注册通用组件服务端(Callee)。
处理步骤
请检查是否已注册通用组件服务端。
16200004 方法已注册
错误信息
The method has been registered.
错误描述
当方法已注册时,方法将返回该错误码。
可能原因
方法已在通用组件服务端(Callee)注册过。
处理步骤
请确认该方法是否已完成注册,避免重复进行注册操作。
16200005 方法未注册
错误信息
The method has not been registered.
错误描述
当方法未注册时,方法将返回该错误码。
可能原因
方法未在通用组件服务端(Callee)注册。
处理步骤
请先在通用组件服务端(Callee)完成该方法的注册,再进行调用。
16300003 目标应用程序不是自身应用程序
错误信息
The target application is not the current application.
错误描述
当被拉起的应用程序不是自身应用程序时,方法将返回该错误码。
可能原因
被拉起的应用和发起调用的应用不是同一个应用程序。
处理步骤
确认被拉起的应用程序是否为自身应用程序。
16300008 指定的包不存在主UIAbility
错误信息
The target bundle has no MainAbility.
错误描述
应用不存在主UIAbility。
可能原因
应用的mainElement不是UIAbility。
处理步骤
检查应用module.json中的mainElement对应的ability是否是UIAbility。
16300009 指定的包不存在状态栏
错误信息
The target bundle has no status-bar ability.
错误描述
应用不存在状态栏。
可能原因
应用不存在状态栏。
处理步骤
检查应用是否有状态栏。
16300010 指定的应用在运行中但没有绑定状态栏
错误信息
The target application is not attached to the status bar.
错误描述
应用运行后没有绑定状态栏。
可能原因
应用有状态栏,但在运行过程中没有绑定状态栏。
处理步骤
检查应用是否绑定状态栏。
28800001 启动任务或其依赖项不存在
错误信息
Startup task or its dependency not found.
错误描述
执行启动任务时,如果找不到该启动任务或其依赖的任务,方法将返回该错误码。
可能原因
未正确配置启动任务或其依赖的任务。
处理步骤
检查启动框架配置文件是否正确编写,并确保所有配置的启动任务均已实现。
28800002 启动任务之间存在循环依赖关系
错误信息
The startup tasks have circular dependencies.
错误描述
在加载启动任务时,如果检测到启动任务之间存在循环依赖,方法将返回该错误码。
可能原因
配置的启动任务之间存在循环依赖关系。
处理步骤
检查启动框架配置文件,确保所有启动任务之间没有循环依赖。
28800003 运行启动任务时发生错误
错误信息
An error occurred while running the startup tasks.
错误描述
运行启动任务时发生错误,方法将返回该错误码。
可能原因
启动任务的代码逻辑存在错误,或者缺少异常处理。
处理步骤
检查实现的启动任务是否存在逻辑错误,并确保每个启动任务中包含异常处理逻辑。
29600001 图片编辑内部错误
错误信息
Internal error.
错误描述
当图片保存时发生内存申请、多线程处理异常等内部错误时,方法将返回该错误码。
可能原因
内存申请、多线程处理等内核通用错误。具体原因可能包括:内部对象为空、处理超时等等。
处理步骤
- 确认系统内存是否足够,设备使用的系统版本是否存在异常。
- 尝试重启设备。
29600002 图片编辑内部错误
错误信息
Image input error.
错误描述
当图片uri不存在或无法解析图片时,方法将返回该错误码。
可能原因
uri不存在或uri非图片类型文件。
处理步骤
检查文件是否存在以及文件类型是否为图片。
29600003 图片大小过大
错误信息
Image too big.
错误描述
入参所传入的图片大小过大。
可能原因
当入参图片大小超过50M时,方法将返回该错误码。
处理步骤
- 尝试将图片编辑后大小控制在50M以内。
- 对图片大小进行校验。
35600001 指定的agentId不存在
错误信息
The specified agentId does not exist.
错误描述
指定的agentId不存在。
可能原因
目标应用中不存在指定agentId对应的AgentCard。
处理步骤
检查一下目标应用的静态配置信息,重新传入正确的agentId。
35600002 IPC消息发送失败
错误信息
Failed to send the IPC message.
错误描述
IPC消息发送失败。
可能原因
- 传入的数据量超过了IPC的限制(200KB)。
- 服务端进程已经退出。
处理步骤
- 检查发送的数据是否超过了规格限制,如果超过了,调整到规格限制内。
- 查看服务端进程是否已经退出,如果已经退出,需要重新获取代理对象。
35600003 调用方已达到最大连接数
错误信息
Maximum connections from the same caller have been reached.
错误描述
调用方已达到最大连接数。
可能原因
调用方同时连接的AgentExtension数量已经达到5次,不允许再发起新的连接请求。
处理步骤
调用方断开一些连接后重新发起连接。