HarmonyOS API:错误码参考

joytrian
发布于 2023-4-13 19:35
浏览
0收藏

版本:v3.1 Beta

通用错误码

更新时间: 2023-02-17 09:19


通用错误码是指ArkTS接口在调用时均有可能出现的错误码信息,比如接口调用时参数检查失败、权限检查失败等场景。


除通用错误码以外,其他错误码只会在对应领域的接口出现。

201 权限校验失败

错误信息

Permission verification failed, usually the result returned by VerifyAccessToken.

错误描述

权限校验失败,应用无权限使用该API,需要申请权限。

可能原因

该错误码表示权限校验失败,通常为没有权限,却调用了需要权限的API。

处理步骤

请检查是否有调用API的权限。

202 系统API权限校验失败

错误信息

Permission verification failed, application which is not a system application uses system API.

错误描述

权限校验失败,非系统应用使用了系统API。

可能原因

非系统应用,使用了系统API,请校验是否使用了系统API。

处理步骤

请检查是否调用了系统API,并且去掉。

401 参数检查失败

错误信息

BusinessError 401: Parameter error. The type of "${parameter name}" must be ${correct parameter type}[or ${other information}].

错误描述

参数检查失败,包括必选参数没有传入,参数类型错误。

可能原因

必选参数没有传入,或者参数类型错误。

处理步骤

请检查必选参数是否没有传入,或者传的参数类型是否错误。

801 该设备不支持此API

错误信息

BusinessError 801: Capability not supported. function ${function name} can not work correctly due to limited device capabilities.

错误描述

该设备不支持此API。通常用于设备已支持该API所需的SysCap,但设备无法支持该SysCap的全部API时,针对少量的不支持的API返回的错误信息。

可能原因

设备支持该API所需的SysCap,但设备本身无法支持此API。

处理步骤

请检查设备是否支持使用的API。

DistributedSchedule错误码

更新时间: 2023-02-17 09:19

16600001 系统服务工作异常

错误信息

The system ability works abnormally.

错误描述

当系统服务工作异常时,会报此错误码。

可能原因

该错误码表示系统服务工作异常,可能原因如下。

  1. DMS服务没有正常启动。
  2. DMS的binder对象无法正常获取。
  3. 流转依赖的其他服务没有正常启动或者binder对象无法获取。

处理步骤

系统服务内部工作异常,请稍后重试,或者重启设备尝试。

16600002 指定的token或callback未注册

错误描述

当调用continuationManager相关的接口时传入的token或callback未提前注册,会报此错误码。

错误信息

The specified token or callback is not registered.

可能原因

该错误码可能原因是指定的token或callback未注册。

处理步骤

请先注册token或callback。

16600003 应用注册token已达到最大次数限制

错误描述

当调用continuationManager.registerContinuation接口时次数过多超出限制,会报此错误码。

错误信息

The number of token registration times has reached the upper limit.

可能原因

该错误码可能原因是应用注册token已达到最大次数限制。

处理步骤

请勿频繁注册,请使用已注册的token。

16600004 指定的callback已注册

错误描述

当使用相同的callback调用continuationManager的on接口时,会报此错误码。

错误信息

The specified callback has been registered.

可能原因

该错误码表示指定的callback已注册,可能原因是使用相同的callback重复注册。

处理步骤

请勿使用相同的callback重复注册。

16300501 系统服务工作异常

错误描述

当系统服务工作异常时,会报此错误码。

错误信息

The system ability works abnormally.

可能原因

该错误码表示系统服务工作异常,可能原因如下。

  1. DMS服务没有正常启动。
  2. DMS的binder对象无法正常获取。
  3. 流转依赖的其他服务没有正常启动或者binder对象无法获取。

处理步骤

系统服务内部工作异常,请稍后重试,或者重启设备尝试。

16300502 获取指定的missionId的missionInfo失败

错误描述

当调用distributedMissionManager.continueMission接口获取指定missionId的missionInfo失败时,会报此错误码。

错误信息

Failed to get the missionInfo of the specified missionId.

可能原因

该错误码表示获取指定的missionId的missionInfo失败,可能原因如下。

  1. missionId输入错误。
  2. missionId对应的missionInfo确实不存在。

处理步骤

请检查输入的missionId是否正确。

16300503 远端未安装应用且不支持免安装

错误描述

当调用distributedMissionManager.continueMission接口使用迁移功能时,若远端未安装应用且不支持免安装,会报此错误码。

错误信息

The application is not installed on the remote end and installation-free is not supported.

可能原因

该错误码可能原因是远端未安装迁移应用并且不支持免安装。

处理步骤

  1. 请检查远端是否已安装需要迁移的应用。
  2. 请检查远端是否支持免安装。

16300504 远端未安装应用但支持免安装,需使用免安装标识重试

错误描述

当调用distributedMissionManager.continueMission接口使用迁移功能时,若远端未安装应用但支持免安装,会报此错误码。

错误信息

The application is not installed on the remote end and installation-free is supported. Try again with the freeInstall flag.

可能原因

该错误码可能原因是远端未安装应用但支持免安装,使用时未使用免安装的标识。

处理步骤

请使用免安装的标识重试。

16300505 操作设备必须是迁移的应用所在的设备或需迁移到的目标设备

错误描述

当调用distributedMissionManager.continueMission接口使用迁移功能时,若操作设备不是迁移的应用所在的设备或需迁移到的目标设备,会报此错误码。

错误信息

The operation device must be the device where the application to be continued is currently located or the target device.

可能原因

该错误码可能原因是操作设备不是迁移的应用所在的设备或需迁移到的目标设备。

处理步骤

请检查操作设备是否是迁移的应用所在的设备或需迁移到的目标设备。

16300506 本地迁移任务已在进行中

错误描述

当调用distributedMissionManager.continueMission接口使用迁移功能时,若本地迁移任务已在进行中,会报此错误码。

错误信息

The local continuation task is already in progress.

可能原因

该错误码表示本地迁移任务已在进行中,可能原因是已经发起了迁移任务还未结束。

处理步骤

请检查是否已经发起了迁移并未结束。

3 序列化对象失败

错误描述

当调用continuationManager相关接口时,若系统参数DMS_PROXY_INTERFACE_TOKEN序列化写失败,会报此错误码。

错误信息

Failed to flatten the object.

可能原因

该错误码表示对象序列化过程中出现错误,可能原因是系统参数DMS_PROXY_INTERFACE_TOKEN序列化写失败。

处理步骤

请检查系统功能是否正常或者重启。

7 空对象

错误信息

The object is null.

错误描述

当调用流转和迁移相关接口时,若出现dms以及其他对象为空或序列化读失败,会报此错误码。

可能原因

该错误码表示接口依赖的服务对象或参数对象为空,可能原因如下。

  1. 入参序列化读失败。
  2. DMS服务没有正常启动或binder对象无法正常获取。
  3. DMS依赖的其他服务没有正常启动或者binder对象无法获取。

处理步骤

  1. 检查入参是否为有效合法值。
  2. 检查DMS服务是否正常启动,重新启动服务或重启设备。
  3. 检查DMS依赖的其他服务是否正常启动,重新启动服务或重启设备。

29360207 注册超出最大次数

错误描述

当调用continuationManager.register接口时次数过多超出限制,会报此错误码。

错误信息

The number of registrations has reached the upper limit.

可能原因

该错误码可能原因是设备频繁注册,次数超出最大次数限制。

处理步骤

重启服务并且避免频繁注册。

29360208 token未注册

错误描述

当调用continuationManager相关接口时使用未注册的token,会报此错误码。

错误信息

The token is not registered.

可能原因

该错误码可能原因是未注册token。

处理步骤

注册token并使用已注册的token。

29360209 callback已注册

错误描述

当使用相同的callback重复调用continuationManager.on接口时,会报此错误码。

错误信息

The callback has been registered.

可能原因

该错误码能原因是指定的callback已经注册过。

处理步骤

请勿使用相同的callback重复注册。

29360210 callback未注册

错误描述

当调用continuationManager的off、updateConnectStatus和startDeviceManager等接口时,若未提前调用on接口注册callback,会报此错误码。

错误信息

The callback is not registered.

可能原因

该错误码可能原因是指定的callback未注册。

处理步骤

注册callback并使用已注册的callback。

29360211 连接ability失败

错误描述

当调用continuationManager的startDeviceManager接口时,若连接相应Ability失败时,会报此错误码。

错误信息

Failed to connect to the ability.

可能原因

该错误码可能原因是指定token连接ability失败。

处理步骤

检查token是否有效以及相应ability是否正常服务,重新启动服务或重启设备。

29360214 callback类型错误

错误描述

当调用continuationManager的on和off接口时,若参数callback类型错误时,会报此错误码。

错误信息

The type of callback is not supported.

可能原因

该错误码表示callback类型错误,可能原因是不支持传入的callback类型。

处理步骤

请使用系统支持的callback类型并传入。

29360215 无效的连接状态

错误描述

当调用continuationManager的updateConnectStatus接口时,若参数status为无效值时,会报此错误码。

错误信息

Invalid connection state.

可能原因

该错误码表示无效的连接状态,可能原因是入参DeviceConnectState为非指定值。

处理步骤

设置指定合法的DeviceConnectState值。

29360216 无效的流转模式

错误信息

Invalid continuation mode.

错误描述

当调用continuationManager的register和startDeviceManager接口时,若参数ContinuationExtraParams.continuationMode为无效值时,会报此错误码。

可能原因

该错误码可能原因是入参ContinuationExtraParams.continuationMode为非指定值。

处理步骤

设置指定合法的ContinuationExtraParams.continuationMode值。


文章转载自:​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/errorcode-distributedschedule-0000001427745152-V3?catalogVersion=V3​

已于2023-4-13 19:35:37修改
收藏
回复
举报
回复
    相关推荐