# ArkTS API错误码

以下授权相关错误码的详细介绍请参见华为账号服务ArkTS错误码。

| 名称 | 值 | 说明 |
| --- | --- | --- |
| PACKAGE_FINGERPRINT_CHECK_ERROR | 1001500001 | 应用指纹证书校验失败。 |
| DUPLICATE_REQUEST_REJECTED | 1001500002 | 重复请求，当已有相同的请求在处理时，返回此错误码，此错误码不需要处理。你的应用需实现点击控制，防止连续点击发起相同请求。 |
| ACCOUNT_NOT_LOGGED_IN | 1001502001 | 华为账号未登录。 |
| APP_NOT_AUTHORIZED | 1001502002 | 应用未授权。 |
| PARAMETER_INVALID | 1001502003 | 无效参数，接口传参异常等。 |
| NETWORK_ERROR | 1001502005 | 网络异常。 |
| INTERNAL_ERROR | 1001502009 | 内部错误，如华为账号服务器错误或其他内部错误等。 |
| USER_CANCELED | 1001502012 | 用户取消授权。 |
| SCOPE_OR_PERMISSION_NOT_REQUESTED | 1001502014 | 应用未申请scopes或permissions权限。 |

#### 201 鉴权失败

**错误信息**

Permission verification failed.

**错误描述**

鉴权失败。

**可能原因**

1、应用指纹配置不正确。

2、缺少权限。

3、部分接口仅白名单用户可调用。

4、测试用户数已达上限。

**处理步骤**

1、检查AGC上应用的指纹证书，详情请见添加公钥指纹。

2、参考管理用户授权，确认用户已授权相关权限。

3、用户申请成为测试用户失败，请尽快参考申请验证获取正式权限，完成管理台应用验收。

4、通过在线提单提交问题，华为支持人员会及时处理。

#### 401 参数不合法

**错误信息**

Parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types; 3.Parameter verification failed.

**错误描述**

参数错误。

**可能原因**

参数填写不正确。

**处理步骤**

1、参考文档确认数据必填项、取值范围等是否填写正确。

2、通过在线提单提交问题，华为支持人员会及时处理。

#### 801 该设备不支持此API

**错误信息**

Capability not supported. Failed to call the API due to limited device capabilities.

**错误描述**

该设备不支持此API，因此无法正常调用。

**可能原因**

可能出现该错误码的场景为：该设备已支持该API所属的Syscap, 但是并不支持此API。

**处理步骤**

应避免在该设备上使用此API，或在代码中通过判断来规避异常场景下应用在不同设备上运行所产生的影响。

#### 1002700001 系统内部错误

**错误信息**

System internal error.

**错误描述**

系统内部错误。

**可能原因**

未知。

**处理步骤**

不同场景，根据具体message提示解决。若仍无法解决，通过在线提单提交问题，华为支持人员会及时处理。

#### 1002700002 数据库异常

**错误信息**

Database processing error.

**错误描述**

数据库异常。

**可能原因**

未知。

**处理步骤**

通过在线提单提交问题，华为支持人员会及时处理。

#### 1002701001 网络错误

**错误信息**

Network error. The network is unavailable.

**错误描述**

网络错误。

**可能原因**

网络未连接。

**处理步骤**

1、检查网络配置。

2、通过在线提单提交问题，华为支持人员会及时处理。

#### 1002702001 账号未登录

**错误信息**

Account error. The user has not logged in with HUAWEI ID.

**错误描述**

账号未登录。

**可能原因**

账号未登录。

**处理步骤**

1、参考管理用户授权，拉起登录授权，登录账号后再重新调用接口。

2、通过在线提单提交问题，华为支持人员会及时处理。

#### 1002702002 账号异常

**错误信息**

Account error. Failed to obtain account information with HUAWEI ID.

**错误描述**

账号异常。

**可能原因**

账号异常。

**处理步骤**

通过在线提单提交问题，华为支持人员会及时处理。

#### 1002703001 用户隐私未同意

**错误信息**

User privacy is not agreed.

**错误描述**

用户隐私未同意。

**可能原因**

用户从未启动过运动健康App。

**处理步骤**

引导用户启动运动健康App，参考FAQ。

#### 1009104001 联动已开启

**错误信息**

Sport service busy. Workout is already started by other application.

**错误描述**

联动已开启。

**可能原因**

应用/其他应用已调用start开启联动。

**处理步骤**

1、检查自身业务流程是否有重复开启联动操作。

2、捕获异常处理其他应用开启联动场景。

#### 1009104002 不支持运动类型

**错误信息**

Unsupported sport type.

**错误描述**

联动不支持该运动类型。

**可能原因**

传入了不支持的运动类型。

**处理步骤**

检查传入的运动类型，请参见锻炼记录类型常量。

#### 1009104003 非法指令

**错误信息**

Illegal command.

**错误描述**

在当前状态下，指令非法。

**可能原因**

1、应用自身调用接口时机错误；其他应用已开启联动。

2、应用自身调用接口时机错误；联动未开启。

3、应用自身调用接口时机错误；联动未结束。

**处理步骤**

1、检查应用自身业务流程。

2、捕获异常处理其他应用开启联动场景。

3、重新选择时机调用接口。

#### 1009104004 权限校验异常

**错误信息**

Permission verification error. Application has no permission, such as Motion Permission.

**错误描述**

应用未具有相关权限，如健身运动权限。

**可能原因**

应用未具有相关权限。

**处理步骤**

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

#### 1009104005 动态库加载异常

**错误信息**

Failed to load the dynamic library.

**错误描述**

动态库加载异常。

**可能原因**

动态库文件不存在或已经有动态库被加载。

**处理步骤**

1、检查load传入路径是否正确。

2、调用load函数，检查是否返回该错误码，返回则代表动态库已经被加载，需要先调用unload函数卸载动态库。

#### 1009104006 动态库卸载异常

**错误信息**

Failed to unload the dynamic library.

**错误描述**

动态库卸载异常。

**可能原因**

动态库已经被卸载。

**处理步骤**

1、检查unload传入路径是否正确。

2、调用unload函数，检查是否返回该错误码，返回则代表动态库已经被卸载，不返回错误码代表动态库卸载成功。

#### 1009104999 通用错误码

**错误信息**

System internal error.

**错误描述**

其他异常。

**可能原因**

其他。

**处理步骤**

不同场景，根据具体message提示解决。若仍无法解决，通过在线提单提交问题，华为支持人员会及时处理。

#### 14500101 服务异常

**错误信息**

Service exception.

**错误描述**

服务异常。

**可能原因**

未知。

**处理步骤**

通过在线提单提交问题，华为支持人员会及时处理。