# 元能力子系统错误码

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

#### 16000001 指定的Ability名称不存在

**错误信息**

The specified ability does not exist.

**错误描述**

当指定的Ability名称不存在时，方法将返回该错误码。

**可能原因**

所查询的Ability不存在。

**处理步骤**

1.  检查Want中的bundleName、moduleName和abilityName是否正确。
2.  检查传入Want中bundleName对应的应用是否安装。可使用如下命令查询已安装的应用列表，若bundleName不在查询结果中，说明应用未安装成功。
    
    ```
    hdc shell bm dump -a
    ```
    
3.  多hap应用需确认ability所属的hap是否已被安装。可使用如下命令查询应用的包信息，若安装的应用中没有对应的hap和ability，说明ability所属的hap未被安装。
    
    ```
    hdc shell bm dump -n 包名
    ```
    

#### 16000002 接口调用Ability类型错误

**错误信息**

Incorrect ability type.

**错误描述**

当调用Ability相关接口时，被调用方的Ability类型与接口期望的类型不匹配。

**可能原因**

1.  被调用方（服务端）的Ability类型与调用方（客户端）接口期望的类型不匹配。
2.  当目标服务端为AppServiceExtensionAbility类型时，未在module.json5配置文件中配置ACL权限（ohos.permission.SUPPORT\_APP\_SERVICE\_EXTENSION）。

**处理步骤**

1.  检查Want中的bundleName、moduleName和abilityName是否正确。
2.  确认被调用方（服务端）的Ability类型与调用接口是否匹配。对于ServiceExtensionAbility，应使用connectServiceExtensionAbility()方法连接。同时需要确保module.json5配置文件中extensionAbilities的type设置为与接口匹配的service。
3.  若被调用方（服务端）为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.

**错误描述**

当可见性校验失败时，方法将返回该错误码。

**可能原因**

应用可见性校验失败。

**处理步骤**

1.  Stage模型下，拉起应用时抛出16000004异常，表示被拉应用调用失败，需要检查被拉应用module.json5的Ability字段的exported配置是否为true。该配置字段为true，表示可以被其他应用调用；该配置字段为false，表示不可以被其他应用调用。
2.  若应用需要拉起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.

**错误描述**

当服务超时时，方法将返回该错误码。

**可能原因**

服务超时。

**处理步骤**

服务超时，请稍后重试。

#### 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。

**可能原因**

1.  隐式启动的参数配置有误。
2.  指定的HAP包未安装。

**处理步骤**

1.  确保隐式启动的参数配置正确，匹配规则详见显式Want与隐式Want匹配规则。
2.  确保对应的HAP包已安装。

#### 16000050 内部错误

**错误信息**

Internal error.

**错误描述**

当出现了开发者无法解决的内部异常错误（如内存申请失败、多线程处理异常、跨进程通信失败等）时，方法将返回该错误码。

**可能原因**

1.  启动Ability时传入的Want数据过大。
2.  设备解锁前拉起非系统应用。
3.  隐式拉起时未安装应用市场App。
4.  开发者无法处理的系统内部错误。包括但不限于：内部对象为空指针、处理超时、IPC跨进程通信失败、包管理获取应用信息失败、系统服务获取失败、启动的Ability实例已达到上限等。

**处理步骤**

1.  对于启动Ability失败时，可以检查传入的Want数据是否过大。
2.  确保在设备解锁前只拉起系统应用，或者延迟拉起非系统应用直到设备解锁。
3.  确保设备上已安装应用市场App，或者在拉起应用前检查应用市场App是否已安装。
4.  对于开发者无法处理的系统内部错误，请尝试重新调用该接口，或者重启设备。

#### 16000053 非顶层应用

**错误信息**

The ability is not on the top of the UI.

**错误描述**

当前应用未显示在界面顶层时，方法将返回该错误码。

**可能原因**

用户执行免安装启动时需要确保应用在前台，但应用未显示在界面顶层。

**处理步骤**

1.  请确保当前应用已启动并处于前台运行状态。
2.  请核实应用界面是否完全显示，且未被其他应用窗口遮挡或最小化。
3.  如设备启用了分屏或多窗口模式，请确保当前应用为焦点窗口。

#### 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相关的参数校验失败时，返回该错误码。

**可能原因**

1.  调用startAbility时，processMode设置为NEW\_PROCESS\_ATTACH\_TO\_STATUS\_BAR\_ITEM或者ATTACH\_TO\_STATUS\_BAR\_ITEM，但是应用在状态栏没有图标，则返回该错误码。
2.  调用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类型不允许严格模式下启动其他三方应用。

**处理步骤**

1.  查看对应Extension类型严格模式开启条件。
2.  以非严格模式启动当前Extension。

#### 16000070 严格模式下不允许该类型Extension启动指定ServiceExtensionAbility

**错误信息**

The extension cannot start the service.

**错误描述**

严格模式下，不允许该类型Extension启动指定ServiceExtensionAbility。

**可能原因**

当前Extension处于严格模式，且对应的Extension类型不允许严格模式下启动指定ServiceExtensionAbility。

**处理步骤**

1.  查看对应Extension类型严格模式开启条件。
2.  以非严格模式启动当前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，返回该错误码。

**可能原因**

1.  调用startAbility时，使用ohos.extra.param.key.appCloneIndex携带的appCloneIndex是一个无效值，则返回该错误码。
    
2.  调用isAppRunning时，入参appCloneIndex是一个无效值，则返回该错误码。
    
3.  尝试连接不支持应用分身的ExtensionAbility时，返回该错误码。
    

**处理步骤**

确认appCloneIndex的约束条件是否满足。

#### 16000074 返回结果时requestCode对应的调用方不存在

**错误信息**

The caller does not exist.

**错误描述**

通过backToCallerAbilityWithResult接口向调用方返回结果时，如果根据传入的requestCode无法找到调用方，返回该错误码。

**可能原因**

1.  requestCode不是通过Want中的CALLER\_REQUEST\_CODE字段获取的。
    
2.  requestCode对应的调用方已经被销毁或结果已经返回。
    

**处理步骤**

1.  确认requestCode是否是通过Want中的CALLER\_REQUEST\_CODE获取的。
    
2.  确认调用方是否被销毁或结果已经返回。
    

#### 16000075 不支持返回结果时拉起调用方

**错误信息**

BackToCaller is not supported.

**错误描述**

不支持通过backToCallerAbilityWithResult接口返回到调用方时，返回该错误码。

**可能原因**

当前应用未进行linkFeature配置或未通过系统审核。

**处理步骤**

1.  确认当前应用已在module.json5文件中配置linkFeature字段。
2.  确认当前应用声明的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.

**错误描述**

应用不支持多实例。

**可能原因**

1.  目标应用未配置多实例。
2.  当前设备类型不支持多实例。

**处理步骤**

1.  对目标应用配置多实例。
2.  在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。

#### 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调用该接口一次。

**可能原因**

1.  调用方不是DelegatorAbility。
2.  调用方是DelegatorAbility，但是重复调用接口。

**处理步骤**

1.  检查调用方是否DelegatorAbility。
2.  检查是否重复调用。

#### 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是否处于前台状态。

#### 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捕获该错误码并进行处理。

#### 16000150 发送请求失败

**错误信息**

Failed to send request to system service.

**错误描述**

当向系统服务发送请求失败时，方法将返回该错误码。

**可能原因**

设置快启使能状态或者重新初始化快启时，发送请求失败。

**处理步骤**

请尝试重新调用接口或者重启设备。

#### 16000151 无效wantAgent对象

**错误信息**

Invalid wantAgent object.

**错误描述**

当传入接口的wantAgent对象无效时，方法将返回该错误码。

**可能原因**

1.  传入接口的wantAgent对象无效。
2.  三方应用设置其他应用的Ability。
3.  其它内部通信错误。

**处理步骤**

1.  检查传入接口的wantAgent对象是否存在。
2.  检查调用方是否为三方应用。不支持三方应用设置其他应用的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接口时服务端还未启动且当前应用无权限拉起目标服务。

**处理步骤**

1.  等待服务端启动后重新连接。
2.  由当前应用拉起目标服务时，需要将接口调用方的app-identifier配置在目标AppServiceExtensionAbility的appIdentifierAllowList中。

#### 16200001 通用组件客户端(Caller)已回收

**错误信息**

The caller has been released.

**错误描述**

当通用组件客户端(Caller)已回收时，方法将返回该错误码。

**可能原因**

通用组件客户端(Caller)已回收。

**处理步骤**

1.  重新创建有效的通用组件客户端(Caller)实例。
2.  检查调用context.startAbility时，context对应的ability是否还在运行。若该ability已被析构，会抛出该错误码。
3.  若存在连续调用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.

**错误描述**

当监听器不存在时，方法将返回该错误码。

**可能原因**

当前监听器不存在或者已注销。

**处理步骤**

请检查是否有重复注销监听器。

#### 29600001 图片编辑内部错误

**错误信息**

Internal error.

**错误描述**

当图片保存时发生内存申请、多线程处理异常等内部错误时，方法将返回该错误码。

**可能原因**

内存申请、多线程处理等内核通用错误。具体原因可能包括：内部对象为空、处理超时等等。

**处理步骤**

1.  确认系统内存是否足够，设备使用的系统版本是否存在异常。
2.  尝试重启设备。

#### 29600002 图片编辑内部错误

**错误信息**

Image input error.

**错误描述**

当图片uri不存在或无法解析图片时，方法将返回该错误码。

**可能原因**

uri不存在或uri非图片类型文件。

**处理步骤**

检查文件是否存在以及文件类型是否为图片。

#### 29600003 图片大小过大

**错误信息**

Image too big.

**错误描述**

入参所传入的图片大小过大。

**可能原因**

当入参图片大小超过50M时，方法将返回该错误码。

**处理步骤**

1.  尝试将图片编辑后大小控制在50M以内。
2.  对图片大小进行校验。

#### 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.

**错误描述**

当前进程不支持设置为备选主控进程。

**可能原因**

当前进程不满足以下任一条件：

1.  运行了isolationProcess字段设为true的组件。
2.  曾经成为过主控进程。

**处理步骤**

不支持处理。当前进程只有运行了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.

**错误描述**

因为存在未完成的请求，放弃当前进程的主控进程身份失败。

**可能原因**

当前进程存在未完成的请求：

1.  进程中存在未完成的onNewProcessRequest请求。
2.  当启动模式为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不存在。

**可能原因**

1.  目标应用中不存在指定agentId对应的AgentCard。

**处理步骤**

1.  检查一下目标应用的静态配置信息，重新传入正确的agentId。

#### 35600002 IPC消息发送失败

**错误信息**

Failed to send the IPC message.

**错误描述**

IPC消息发送失败。

**可能原因**

1.  传入的数据量超过了IPC的限制(200KB)。
2.  服务端进程已经退出。

**处理步骤**

1.  检查发送的数据是否超过了规格限制，如果超过了，调整到规格限制内。
2.  查看服务端进程是否已经退出，如果已经退出，需要重新获取代理对象。

#### 35600003 调用方已达到最大连接数

**错误信息**

Maximum connections from the same caller have been reached.

**错误描述**

调用方已达到最大连接数。

**可能原因**

调用方同时连接的AgentExtension数量已经达到5次，不允许再发起新的连接请求。

**处理步骤**

调用方断开一些连接后重新发起连接。

#### 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。