以下仅介绍本模块特有错误码，通用错误码请参考通用错误码说明文档。
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
元能力子系统错误码
本文导读
说明
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类型与调用接口是否匹配。对于ServiceExtensionAbility，应使用connectServiceExtensionAbility()方法连接。同时需要确保module.json5配置文件中extensionAbilities的type设置为与接口匹配的service。
- 若被调用方（服务端）为appService类型，需在服务端的module.json5配置文件中配置ACL权限（ohos.permission.SUPPORT_APP_SERVICE_EXTENSION）。
16000003 指定的ID不存在
错误信息
The specified ID does not exist.
错误描述
当指定的ID不存在时，方法将返回该错误码。
可能原因
操作的目标ID不存在。
处理步骤
确认操作的ID是否存在。
16000004 可见性校验失败
错误信息
Cannot start an invisible component.
错误描述
当可见性校验失败时，方法将返回该错误码。
可能原因
应用可见性校验失败。
处理步骤
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.
错误描述
当服务超时时，方法将返回该错误码。
可能原因
服务超时。
处理步骤
服务超时，请稍后重试。
16000018 限制API 11以上版本三方应用跳转
错误信息
Redirection to a third-party application is not allowed in API version greater than 11.
错误描述
当应用API版本大于11的时候，不允许显式跳转到其他三方应用。
可能原因
应用使用的API版本大于11并且显式跳转到其他三方应用。
处理步骤
使用隐式启动方式或通过openLink跳转其他应用。
16000019 隐式启动未查找到匹配Ability
错误信息
No matching ability is found.
错误描述
隐式启动无法查找到匹配的Ability。
可能原因
- 隐式启动的参数配置有误。
- 指定的HAP包未安装。
处理步骤
- 确保隐式启动的参数配置正确，匹配规则详见显式Want与隐式Want匹配规则。
- 确保对应的HAP包已安装。
16000020 传入的Context对象不是Ability级别Context
错误信息
The context is not ability context.
错误描述
传入的Context对象不是Ability级别Context。
可能原因
传入的Context对象既不是UIAbilityContext或ExtensionContext，也没有继承自UIAbilityContext或ExtensionContext。
处理步骤
使用UIAbilityContext或ExtensionContext对象作为入参，或者使用继承了UIAbilityContext或ExtensionContext类的对象作为入参。
16000050 内部错误
错误信息
Internal error.
错误描述
当出现了开发者无法解决的内部异常错误（如内存申请失败、多线程处理异常、跨进程通信失败等）时，方法将返回该错误码。
可能原因
- 启动Ability时传入的Want数据过大。
- 设备解锁前拉起非系统应用。
- 调用openAtomicService拉起元服务时，安装未完成前用户点击取消，应用市场返回user_cancel错误码，导致安装失败。
- 开发者无法处理的系统内部错误。包括但不限于：内部对象为空指针、处理超时、IPC跨进程通信失败、包管理获取应用信息失败、系统服务获取失败、启动的Ability实例已达到上限等。
- 隐式拉起时未安装应用市场App。
处理步骤
- 对于启动Ability失败时，可以检查传入的Want数据是否过大。
- 确保在设备解锁前只拉起系统应用，或者延迟拉起非系统应用直到设备解锁。
- 若因用户取消元服务安装导致报错，属于正常用户行为，可引导用户重新调用openAtomicService完成安装。
- 对于开发者无法处理的系统内部错误，请尝试重新调用该接口，或者重启设备。
- 确保设备上已安装应用市场App，或者在拉起应用前检查应用市场App是否已安装。
16000053 非顶层Ability
错误信息
The ability is not on the top of the UI.
错误描述
当前Ability未显示在界面顶层时，方法将返回该错误码。
可能原因
用户执行免安装启动时需要确保Ability在前台，但Ability未显示在界面顶层。
处理步骤
- 请确保当前Ability已启动并处于前台运行状态。
- 请核实Ability界面是否完全显示，且未被其他Ability窗口遮挡或最小化。
- 如设备启用了分屏或多窗口模式，请确保当前Ability为焦点窗口。
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 does not exist.
错误描述
指定的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创建自己的实例，不允许应用间启动时为其他应用创建实例。否则，返回该错误码。
可能原因
参数使用场景有误。
处理步骤
16000082 UIAbility正在启动中
错误信息
The UIAbility is being started.
错误描述
UIAbility正在启动中，onCreate或onWindowStageCreate生命周期回调尚未完成。
可能原因
UIAbility仍处于启动阶段，onCreate或onWindowStageCreate回调尚未执行完成。
处理步骤
等待UIAbility完成onCreate或onWindowStageCreate生命周期回调后再执行相关操作。
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方法执行失败
错误信息
-
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实例。
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是否处于前台状态。
16000122 待启动的目标组件被系统管控模块拦截
错误信息
The target component is blocked by the system module and does not support startup.
错误描述
待启动的目标组件被系统管控模块拦截，不支持启动。
可能原因
系统管控模块拦截了目标应用的启动。
处理步骤
如果无法启动目标UIAbility，可以尝试启动其他UIAbility。
16000123 不支持隐式启动
错误信息
Implicit startup is not supported.
错误描述
不支持隐式启动。
可能原因
wantList参数中存在隐式Want。
处理步骤
检查wantList参数，确保不存在隐式Want，若存在则将其修改为显式Want。
16000124 不支持启动分布式UIAbility
错误信息
Starting a remote UIAbility is not supported.
错误描述
不支持启动分布式UIAbility。
可能原因
Want中的deviceId不为空且非本机的设备ID。
处理步骤
将Want中的deviceId字段设为空，或配置为本机的deviceId。
16000125 不支持启动插件UIAbility
错误信息
Starting a plugin UIAbility is not supported.
错误描述
不支持启动插件。
可能原因
Want中的parameters指定了启动插件UIAbility。
处理步骤
检查Want中的parameters参数，不要将ohos.params.pluginAbility设置为true。
16000130 UIAbility不属于调用方
错误信息
The UIAbility not belong to caller.
错误描述
目标UIAbility不属于调用方。
可能原因
启动了一个非自身应用的UIAbility。
处理步骤
检查目标UIAbility信息是否属于自身应用。
16000131 UIAbility已启动
错误信息
The UIAbility is already exists, 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捕获该错误码并进行处理。
16000150 发送请求失败
错误信息
Failed to send request to system service.
错误描述
当向系统服务发送请求失败时，方法将返回该错误码。
可能原因
设置快启使能状态或者重新初始化快启时，发送请求失败。
处理步骤
请尝试重新调用接口或者重启设备。
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中。
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)是否存在。
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.
错误描述
当被拉起的应用程序不是自身应用程序时，方法将返回该错误码。
可能原因
被拉起的应用和发起调用的应用不是同一个应用程序。
处理步骤
确认被拉起的应用程序是否为自身应用程序。
16300004 指定的observer不存在
错误信息
The observer does not exist.
错误描述
当observer不存在时，方法将返回该错误码。
可能原因
当前observer不存在或者已注销。
处理步骤
请检查是否有重复注销observer。
29600001 图片编辑内部错误
错误信息
Internal error.
错误描述
当图片保存时发生内存申请、多线程处理异常等内部错误时，方法将返回该错误码。
可能原因
内存申请、多线程处理等内核通用错误。具体原因可能包括：内部对象为空、处理超时等等。
处理步骤
- 确认系统内存是否足够，设备使用的系统版本是否存在异常。
- 尝试重启设备。
29600002 图片输入错误
错误信息
Image input error.
错误描述
当图片uri不存在或无法解析图片时，方法将返回该错误码。
可能原因
uri不存在或uri非图片类型文件。
处理步骤
检查文件是否存在以及文件类型是否为图片。
29600003 图片大小过大
错误信息
Image too big.
错误描述
入参所传入的图片大小过大。
可能原因
当入参图片大小超过50M时，方法将返回该错误码。
处理步骤
- 尝试将图片编辑后大小控制在50M以内。
- 对图片大小进行校验。
28800001 启动任务或其依赖项不存在
错误信息
Startup task or its dependency not found.
错误描述
执行启动任务时，如果找不到该启动任务或其依赖的任务，方法将返回该错误码。
可能原因
未正确配置启动任务或其依赖的任务。
处理步骤
检查启动框架配置文件是否正确编写，并确保所有配置的启动任务均已实现。
28800002 启动任务之间存在循环依赖关系
错误信息
The startup tasks have circular dependencies.
错误描述
在加载启动任务时，如果检测到启动任务之间存在循环依赖，方法将返回该错误码。
可能原因
配置的启动任务之间存在循环依赖关系。
处理步骤
检查启动框架配置文件，确保所有启动任务之间没有循环依赖。
28800003 运行启动任务时发生错误
错误信息
An error occurred while running the startup tasks.
错误描述
运行启动任务时发生错误，方法将返回该错误码。
可能原因
启动任务的代码逻辑存在错误，或者缺少异常处理。
处理步骤
检查实现的启动任务是否存在逻辑错误，并确保每个启动任务中包含异常处理逻辑。
28800004 执行启动任务超时
错误信息
Running startup tasks timeout.
错误描述
如果启动任务的执行时间超过设置的超时时间（默认为10000毫秒），方法将返回该错误码。
可能原因
启动任务中包含大量耗时操作，或者设置的超时时间过短。
处理步骤
根据需要调整超时时间。超时时间的设置可参见设置启动参数。
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中调用，不支持该操作。
处理步骤
请将接口调用逻辑迁移到主线程中执行。
10110000 装饰器参数声明错误
错误信息
Decorator parameters must be compile-time constants.
错误描述
代码中使用变量作为装饰器参数，要求使用编译期常量（如字符串字面量）。
可能原因
装饰器参数使用变量。
处理步骤
将装饰器参数从变量改为固定值。
10110001 装饰器使用位置错误
错误信息
The intent decorator can only be used in .ets files.
错误描述
意图装饰器使用在非.ets文件中。
可能原因
意图装饰器使用在非.ets文件中。
处理步骤
在.ets文件中使用意图装饰器。
10110002 装饰器调用形式错误
错误信息
Decorators must be called as functions.
错误描述
装饰器未使用函数调用形式。
可能原因
装饰器未使用函数调用形式。
处理步骤
补充括号，确保装饰器以函数形式调用。
10110003 装饰器未提供必选参数
错误信息
Required parameters are missing for the decorator.
错误描述
装饰器未提供必选参数。
可能原因
装饰器未提供必选参数。
处理步骤
根据错误提示添加必选参数。
10110004 参数类型不符合装饰器参数要求
错误信息
The parameter type does not match the decorator's requirement.
错误描述
参数类型不符合装饰器参数要求。
可能原因
参数类型不符合装饰器参数要求。
处理步骤
根据错误提示调整参数类型。
10110005 解析装饰器参数错误
错误信息
Unsupported parameters found in the decorator.
错误描述
装饰器参数中有不支持解析的参数。
可能原因
装饰器参数中写入了不支持解析的参数。
处理步骤
根据错误提示移除不支持解析的参数（仅支持：string/number/boolean/object/array类型）。
10110006 存在循环依赖错误
错误信息
Circular dependencies detected in decorator parameters.
错误描述
装饰器参数中存在循环依赖。
可能原因
装饰器参数中写入了循环依赖。
处理步骤
重构数据结构，通过提取公共变量或使用ID引用替代直接嵌套。
10110007 参数定义根类型非object类型
错误信息
The root type of the JSON Schema for Parameters must be object.
错误描述
Parameters参数定义的JSON Schema的第一层type非object。
可能原因
Parameters参数定义的JSON Schema的第一层type非object。
处理步骤
确保Parameters的JSON Schema顶层定义为{"type":"object"}。
10110008 类属性缺少必填项
错误信息
A required field in the class property is missing.
错误描述
类属性中缺少JSON Schema定义的必填字段。
可能原因
类属性中没有写JSON Schema定义的必填字段。
处理步骤
根据错误提示补充必选参数。
10110009 类属性字段类型不符合JSON Schema要求
错误信息
The field type of the class property does not match the JSON Schema.
错误描述
类属性中字段类型与JSON Schema要求不符。
可能原因
类属性中的字段类型不符合JSON Schema要求。
处理步骤
根据错误提示修正参数类型。
10110010 类属性参数不符合oneOf/anyOf校验规则
错误信息
The class property parameter violates the oneOf/anyOf validation rules in the JSON Schema.
错误描述
类属性参数不符合JSON Schema中oneOf/anyOf校验规则。
可能原因
类属性中的参数不符合JSON Schema的oneOf/anyOf的校验规则。
处理步骤
修改参数满足校验规则。
10110011 类属性中定义可选参数外的参数
错误信息
The class property includes parameters not defined in the JSON Schema.
错误描述
类属性中使用了JSON Schema定义的可选参数外的参数。
可能原因
类属性中写入了可选参数以外的参数。
处理步骤
删除多余参数。
10110012 存在重复的intentName定义
错误信息
Duplicate intentName definitions found.
错误描述
存在重复的intentName定义。
可能原因
模块中声明了一样的intentName。
处理步骤
在模块中查找重名的intentName并重命名。
10110013 @InsightIntentFunctionMethod装饰的方法位置错误
错误信息
Methods decorated with @InsightIntentFunctionMethod must be in a class decorated with @InsightIntentFunction.
错误描述
@InsightIntentFunctionMethod装饰的方法未在@InsightIntentFunction装饰的类中。
可能原因
@InsightIntentFunctionMethod装饰的方法未在@InsightIntentFunction装饰的类中。
处理步骤
将方法移至@InsightIntentFunction装饰的类中，或为类添加@InsightIntentFunction装饰器。
10110014 未导出@InsightIntentFunction装饰的类
错误信息
The class decorated with @InsightIntentFunction must be exported.
错误描述
@InsightIntentFunction装饰的类未使用export导出。
可能原因
未使用export导出@InsightIntentFunction装饰的类。
处理步骤
为类添加export导出语句。
10110015 @InsightIntentFunctionMethod装饰的方法错误
错误信息
Methods decorated with @InsightIntentFunctionMethod must be static.
错误描述
@InsightIntentFunctionMethod装饰的方法不是static方法。
可能原因
@InsightIntentFunctionMethod装饰的方法未使用static修饰。
处理步骤
使用static修饰@InsightIntentFunctionMethod装饰的方法。
10110016 @InsightIntentPage装饰器修饰位置错误
错误信息
@InsightIntentPage must be applied to a struct page.
错误描述
@InsightIntentPage装饰器未修饰在struct类型的页面上。
可能原因
@InsightIntentPage装饰器修饰在普通类上。
处理步骤
将@InsightIntentPage装饰器移至struct页面上。
10110017 @InsightIntentPage的pagePath匹配页面错误
错误信息
pagePath in @InsightIntentPage does not match the actual page path.
错误描述
@InsightIntentPage的pagePath未匹配实际页面。
可能原因
@InsightIntentPage的pagePath不正确。
处理步骤
确保目录下的文件路径一致。
10110018 @InsightIntentEntry装饰的类继承错误
错误信息
Classes decorated with @InsightIntentEntry must inherit from InsightIntentEntryExecutor.
错误描述
@InsightIntentEntry装饰的类未继承InsightIntentEntryExecutor基类。
可能原因
@InsightIntentEntry装饰的类未继承InsightIntentEntryExecutor基类。
处理步骤
为类添加InsightIntentEntryExecutor基类。
10110019 未导出@InsightIntentEntry装饰的类
错误信息
The class decorated with @InsightIntentEntry must be exported as default.
错误描述
@InsightIntentEntry装饰的类未使用export default导出。
可能原因
未使用export default导出@InsightIntentEntry装饰的类。
处理步骤
为类添加export default导出语句。
10110020 类被多个@InsightIntentEntity装饰器重复标记
错误信息
Multiple @InsightIntentEntity decorators applied to the same class.
错误描述
同一类被多个@InsightIntentEntity装饰器重复标记。
可能原因
多个@InsightIntentEntity装饰器修饰同一个类。
处理步骤
移除多余的@InsightIntentEntity装饰器。
10110021 @InsightIntentEntity装饰的类未实现InsightIntent.IntentEntity接口
错误信息
Classes decorated with @InsightIntentEntity must implement InsightIntent.IntentEntity.
错误描述
@InsightIntentEntity装饰的类未实现InsightIntent.IntentEntity接口。
可能原因
@InsightIntentEntity装饰的类未实现InsightIntent.IntentEntity接口。
处理步骤
确保类实现InsightIntent.IntentEntity或继承自其他意图实体。
10110022 @InsightIntentForm装饰器修饰位置错误
错误信息
@InsightIntentForm must be applied to formExtensionAbility.
错误描述
@InsightIntentForm装饰器没有修饰在formExtensionAbility上。
可能原因
@InsightIntentForm装饰器没有修饰在formExtensionAbility上。
处理步骤
将@InsightIntentForm装饰器移至formExtensionAbility类上。
10110023 @InsightIntentForm装饰器的参数formName匹配错误
错误信息
formName in @InsightIntentForm must match the widget name registered in formExtensionAbility.
错误描述
@InsightIntentForm装饰器的参数formName未匹配到该formExtensionAbility中注册的卡片名称。
可能原因
@InsightIntentForm装饰器的参数formName声明不正确。
处理步骤
检查并修正formName使其匹配到所装饰的formExtensionAbility中注册的卡片名称。
10110024 module.json5配置文件不存在
错误信息
The module.json5 file is missing.
错误描述
工程中未找到module.json5配置文件。
可能原因
module.json5配置文件被删除或者移动。
处理步骤
检查文件路径（通常在entry/src/main/config.json或module.json5），确认文件是否被误删或移动。
10110025 无法写入意图配置文件
错误信息
Failed to write to the intent configuration file.
错误描述
无法写入意图配置文件。
可能原因
权限不足或磁盘空间已满。
处理步骤
检查文件权限（确保DevEco Studio或命令行工具具有写入权限），清理磁盘空间，或重启开发环境。
10110027 生成OHMUrl失败
错误信息
Generating standard OHMUrl failed with useNormalizedOHMUrl configuration not set to true.
错误描述
生成标准OHMUrl失败，useNormalizedOHMUrl配置未设置为true。
可能原因
useNormalizedOHMUrl未设置或者设置为false。
处理步骤
在应用级build-profile.json5中将useNormalizedOHMUrl设置为true。
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次，不允许再发起新的连接请求。
处理步骤
调用方断开一些连接后重新发起连接。
16000161 当前进程延迟退出未处于等待状态，无法调用此API
错误信息
Delayed process exit is not pending in the current process, and this API cannot be called.
错误描述
在当前进程中，由于延迟退出进程未处于等待状态，因此无法调用此API。
可能原因
调用方在调用该API前，未启用当前进程延迟退出功能。
处理步骤
调用方先调用启用当前进程延迟退出接口，再调用该API。
16000162 当前的进程中仍有其他UIAbility，无法调用此API
错误信息
The current process still has another UIAbility, and this API cannot be called.
错误描述
当前的进程中仍有其他UIAbility，此API无法被调用。
可能原因
调用方当前进程中还存在其他的UIAbility。
处理步骤
调用方保证当前进程中只有一个UIAbility且处于退出状态。
16000163 文件类型错误
错误信息
The file type is incorrect.
错误描述
文件类型错误。
可能原因
- 调用appMemoryOptimizer.evictFilePages接口时，传入的fileNames数组里的文件名未以.so、.hap或.hsp结尾。
- 调用appMemoryOptimizer.evictModuleFilePages接口时，memory_optimizer.json配置文件中evictFilePages数组里的文件名未以.so、.hap或.hsp结尾。
处理步骤
- 若调用appMemoryOptimizer.evictFilePages接口，检查传入的fileNames数组，确保所有文件名均以.so、.hap或.hsp结尾。
- 若调用appMemoryOptimizer.evictModuleFilePages接口，检查对应模块的memory_optimizer.json配置文件，确保evictFilePages数组中所有文件名均以.so、.hap或.hsp结尾。
16000164 解析配置文件失败
错误信息
Failed to parse the configuration file.
错误描述
解析配置文件失败。
可能原因
调用appMemoryOptimizer.evictModuleFilePages接口时，memory_optimizer.json配置文件不存在、路径错误或内容格式错误。
处理步骤
检查对应模块目录下src/main/resources/rawfile/memory_optimizer.json配置文件是否存在，并确认其内容格式是否正确。
35600004 指定的AgentCard版本低于当前版本
错误信息
The specified AgentCard version is older than the current version.
错误描述
指定的AgentCard版本低于当前版本。
可能原因
调用updateAgentCard接口时新版本号低于旧版本号。
处理步骤
将AgentCard中的version字段进行更新。
35600005 指定的AgentCard版本无效
错误信息
The specified AgentCard version is invalid.
错误描述
指定的AgentCard版本无效。
可能原因
AgentCard中的version字段没有遵循SemVer的版本规则。
处理步骤
更新AgentCard中的version字段并遵循SemVer的版本规则。
35600006 指定的AgentCard已被注册
错误信息
The specified AgentCard has already been registered. Use updateAgentCard instead.
错误描述
指定的AgentCard已被注册，请使用updateAgentCard接口。
可能原因
指定的AgentCard已被注册。
处理步骤
使用updateAgentCard接口。
35600007 指定的LOW_CODE类型智能体已触发且尚未完成工作流
错误信息
The specified LOW_CODE agent has already been triggered and is not yet completed.
错误描述
指定的LOW_CODE类型智能体已触发且尚未完成工作流。
可能原因
指定的LOW_CODE类型智能体已触发且尚未完成工作流。
处理步骤
调用notifyLowCodeAgentComplete接口结束指定的LOW_CODE类型智能体。
35600008 同一应用下AgentCard数量达到了上限
错误信息
The number of AgentCards in the bundle reaches the limit.
错误描述
同一应用下AgentCard数量达到了上限。
可能原因
同一应用下最多只能存在1000张AgentCard，调用agentManager.registerAgentCard接口时已达到此上限。
处理步骤
调用agentManager.deleteAgentCard删除不再需要的AgentCard。
