reference/apis-basic-services-kit/errorcode-account.md

# 账号管理错误码

<!--Kit: Basic Services Kit-->
<!--Subsystem: Account-->
<!--Owner: @steven-q-->
<!--Designer: @JiDong-CS1-->
<!--Tester: @zhaimengchao-->
<!--Adviser: @zengyawen-->

> **说明：**
>
> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。

以下错误码包括系统账号、分布式账号和应用账号错误码。

## 12300001 系统服务异常

**错误信息**

The system service works abnormally.

**可能原因**

该错误码表示系统服务异常，可能原因如下：
1. 账号管理服务无法正常启动。
2. 账号管理的IPC对象无法获取。
3. 账号管理依赖的其他服务无法正常启动或者IPC对象无法获取。
4. 服务未初始化。
5. 磁盘空间不足。
6. 读写文件异常。
7. 创建目录异常。
8. 创建删除文件异常。
9. 读写数据库异常。

**处理步骤**

请稍后重试，或重启设备。

## 12300002 无效参数

**错误信息**

Invalid parameter.

**可能原因**

该错误码表示传入无效的参数，可能原因如下：
1. 用户名为空。
2. 系统账号用户名长度大于1024。
3. 分布式账号用户名长度大于256。
4. 系统账号id小于0、小于100或大于1099。
5. 分布式账号id长度大于512。
6. 分布式账号传入不支持的事件类型。
7. 域名为空。
8. 域名长度大于128。
9. 域账号为空。
10. 域账号长度大于512。
11. 约束为空。
12. 约束长度大于128。
13. 传入无效的认证和查询参数。
14. 提供的系统账号头像编码字符串长度超过4KB。
15. 提供的分布式账号头像编码字符串长度超过2MB。
16. 提供非jpg和png的图片。
17. 应用账号名长度超过512。
18. 鉴权类型长度超过1024。
19. 令牌长度超过1024。
20. 键名长度超过1024。
21. 自定义数据值长度超过1024。
22. 无效的令牌。
23. 无效的上下文标识。
24. 无效的凭据标识。

**处理步骤**

请传入正确的参数。

## 12300003 账号不存在

**错误信息**

The account does not exist.

**可能原因**

该错误码表示操作的账号不存在，可能原因如下：
1. 查询/激活/删除未创建的账号。
2. 查询/激活/删除已删除的账号。
3. 为已删除的账号设置约束/用户名/头像。
4. 更新未创建的账号。
5. 为不存在的账号设置/取消账号信息访问授权。
6. 为不存在的账号设置/删除/查询密码。
7. 为不存在的账号设置/删除令牌。
8. 为不存在的账号设置额外信息。
9. 为不存在的账号设置/删除凭据。
10. 为不存在的账号设置自定义数据。
11. 为不存在的账号使能分布式同步功能。

**处理步骤**

请检查账号是否存在。

## 12300004 账号已存在

**错误信息**

The account already exists.

**可能原因**

该错误码表示账号已存在，可能原因如下：
创建已存在的账号。

**处理步骤**

请取消创建，或使用其他账号名重试。

## 12300005 不支持多用户

**错误信息**

Multi-user is not supported.

**可能原因**

该错误码表示不支持多用户，可能原因如下：
当前设备不支持多用户，无法创建账号。

**处理步骤**

无法创建其他账号，请取消创建。

## 12300006 不支持的账号类型

**错误信息**

The account type is not supported.

**可能原因**

该错误码表示提供了不支持的账号类型，可能原因如下：当前设备不支持创建指定类型的账号。

**处理步骤**

请创建其他类型的账号。

## 12300007 账号数量已达上限

**错误信息**

The number of accounts has reached the upper limit.

**可能原因**

该错误码表示账号数量已达上限，可能原因如下：创建系统账号/应用账号时，已存在1000个账号。

**处理步骤**

请删除其他账号后再创建。

## 12300008 受限的账号

**错误信息**

The specified account is restricted.

**可能原因**

该错误码表示操作的是受限账号，可能原因如下：
1. 删除系统保留用户。
2. 查询系统保留用户的约束源类型。
3. 创建id为0-100的账号。

**处理步骤**

指定id为系统保留用户，无法操作。

## 12300009 账号已激活

**错误信息**

The account has been activated.

**可能原因**

该错误码表示账号已激活，可能原因如下：
激活已激活的账号。

**处理步骤**

当前账号已激活，请勿重复操作。

## 12300010 账号服务忙碌

**错误信息**

The account service is busy.

**可能原因**

该错误码表示账号服务忙，可能原因如下：
1. 短时间内提交重复请求，如重复激活、重复设置等。
2. 应用账号的认证会话数量超过256，无法处理新的认证请求。

**处理步骤**

请等待一段时间后重试，并降低调用频率。

## 12300011 事件监听器已注册

**错误信息**

The event listener has been registered.

**可能原因**

该错误码表示监听器已注册，可能原因如下：
当前应用向系统注册一个已经注册过的监听器，无法重复注册。

**处理步骤**

请取消注册，或使用未注册过的监听器重新注册。

## 12300012 事件监听器未注册

**错误信息**

The event listener has not been registered.

**可能原因**

该错误码表示监听器未注册，可能原因如下：
解注册一个未注册过的监听器。

**处理步骤**

请使用已注册的监听器执行解注册操作。

## 12300013 网络异常

**错误信息**

Network exception.

**可能原因**

该错误码表示网络异常，可能原因如下：
1. 未连接网络。
2. 联网异常。
3. 应用无联网权限。
4. 未知的网络错误。

**处理步骤**

1. 连接网络。
2. 确保网络可以正常联网。
3. 确保应用具有联网权限。
4. 重试相关操作。

## 12300014 域账号未认证

**错误信息**

The domain account is not authenticated.

**可能原因**

域账号未登录。

**处理步骤**

先登录域账号。

## 12300015 短名称已存在

**错误信息**

The short name already exists.

**可能原因**

创建账号使用的短名称已经存在。

**处理步骤**

更换别的不存在的短名称。

## 12300016 账号登录数已达上限

**错误信息**

The number of logged in accounts reaches the upper limit.

**可能原因**

登录的账号数已经达到上限，不能再登录新账号。

**处理步骤**

将已经登录的账号退出，再登录新的账号。

<!--Del-->

## 12300021 系统账号已绑定域账号

**错误信息**

The OS account is already bound.

**错误描述**

输入的系统账号已绑定域账号。

**可能原因**

输入的系统账号已绑定域账号。

**处理步骤**

系统账号不允许重复绑定域账号，请更换系统账号进行绑定。

## 12300022 域账号已被绑定

**错误信息**

The domain account is already bound.

**错误描述**

输入的域账号已绑定系统账号。

**可能原因**

输入的域账号已绑定系统账号。

**处理步骤**

同一域账号不允许绑定多个系统账号，请更换域账号或删除绑定的账号后再进行绑定。

<!--DelEnd-->

## 12300101 凭据不正确

**错误信息**

The credential is incorrect.

**可能原因**

该错误码表示凭据不正确，可能原因如下：
1. 密码输入错误；
2. 生物特征不匹配；
3. 令牌失效；

**处理步骤**

请输入正确有效的凭据重试。

## 12300102 凭据不存在

**错误信息**

The credential does not exist.

**可能原因**

该错误码表示凭据不存在，可能原因如下：
1. 认证未录入的凭据类型。
2. 查询未录入的凭据类型。
3. 删除未录入的凭据类型。

**处理步骤**

请确认凭据类型是否存在。

## 12300103 凭据输入器已注册

**错误信息**

The credential inputer already exists.

**可能原因**

该错误码表示凭据输入器已注册，可能原因如下：
PIN码输入器已注册，解注册之前无法重复注册。

**处理步骤**

凭据输入器已存在，请勿重复操作。

## 12300104 凭据输入器不存在

**错误信息**

The credential inputer is not found.

**可能原因**

该错误码表示凭据输入器不存在，可能原因如下：
认证、添加、修改凭据时，未注册凭据输入器。

**处理步骤**

注册凭据输入器。

## 12300105 可信等级不支持

**错误信息**

The trust level is not supported.

**可能原因**

该错误码表示可信等级不支持，可能原因如下：
传入系统不支持的可信等级。

**处理步骤**

请输入正确的可信等级。

## 12300106 认证类型不支持

**错误信息**

The authentication type is not supported.

**可能原因**

该错误码表示认证类型不支持，可能原因如下：
传入系统不支持的认证类型。

**处理步骤**

请提供系统支持的认证类型。

## 12300107 认证类型不存在

**错误信息**

The authentication type does not exist.

**可能原因**

该错误码表示认证类型不存在，可能原因如下：
查询/删除令牌时，指定的鉴权类型不存在。

**处理步骤**

请使用存在的认证类型查询/删除。

## 12300108 认证会话不存在

**错误信息**

The authentication session does not exist.

**可能原因**

该错误码表示会话不存在，可能原因如下：

查询不存在的会话回调。

**处理步骤**

请使用已成功打开的会话标识查询会话回调。

## 12300109 认证、凭据录入、更新等操作被取消

**错误信息**

The authentication, enrollment, or update operation is canceled.

**可能原因**

该错误码表示认证、凭据录入、更新等操作被取消，可能原因如下：
认证过程中，用户取消认证操作。
录入凭据过程中，用户取消录入操作。
录入凭据过程中，用户取消更新操作。

**处理步骤**

重新或结束认证操作。

## 12300110 认证被锁定

**错误信息**

The authentication is locked.

**可能原因**

该错误码表示认证被锁定，可能原因如下：
认证类型错误次数超过上限。

**处理步骤**

认证错误次数超过上限，请在freezingTime之后重试。

## 12300111 认证超时

**错误信息**

The authentication time out.

**可能原因**

该错误码表示认证超时，可能原因如下：
1. 对于系统账号，认证、录入超过三分钟。
2. 认证服务因网络原因无法及时响应而超时。

**处理步骤**

1. 认证录入超时，请重试。
2. 请确认网络环境无问题后重试。

## 12300112 认证服务忙

**错误信息**

The authentication service is busy.

**可能原因**

该错误码表示认证服务忙，可能原因如下：
系统账号认证时，认证总数超过5个。
应用账号认证时，三方应用的认证器服务忙碌（根据实际情况决定）。

**处理步骤**

当前认证服务忙，请稍后重试。

## 12300113 认证服务不存在

**错误信息**

The account authentication service does not exist.

**可能原因**

该错误码表示认证服务不存在，可能原因如下：
对于应用账号：
1. 请求鉴权时，账号所属应用不支持认证器服务。
2. 隐式添加账号时，账号所属应用不支持认证器服务。
3. 验证指定账号的凭据时，该账号所属应用不支持认证器服务。
4. 设置应用的认证器属性时，指定的应用不支持认证器服务。
5. 检查账号标签时，指定的应用不支持认证器服务。

**处理步骤**

请取消操作，或向支持认证服务的应用进行认证。

## 12300114 认证服务异常

**错误信息**

The account authentication service works abnormally.

**可能原因**

该错误码表示账号认证服务异常，可能原因如下：
1. 身份认证服务出现未知错误。
2. 应用认证器不符合规范。

**处理步骤**

1. 请重试或重启系统。
2. 请按照规范开发应用认证器。

## 12300115 用户认证密码个数达到上限

**错误信息**

The number of credentials reaches the upper limit.

**可能原因**

1. 身份认证服务出现未知错误。
2. 用户已有对应类型的密码，不能再添加密码。

**处理步骤**

1. 请重试或重启系统。
2. 请修改密码或删除已有密码。

## 12300116 凭证复杂度验证失败

**错误信息**

Credential complexity verification failed.

**可能原因**

设置的凭证太过简单。

**处理步骤**

按照要求录入包含特定字符的凭证。

## 12300117 PIN码过期

**错误信息**

PIN is expired.

**可能原因**

用户认证的PIN码过期。

**处理步骤**

重新设置PIN码。

## 12400001 应用不存在

**错误信息**

The application does not exist.

**可能原因**

该错误码表示应用不存在，可能原因如下：
1. 设置访问权限时，目标应用不存在。
2. 设置开放授权时，目标应用不存在。

**处理步骤**

请取消设置，或使用已安装的应用包名重试。

## 12400002 自定义数据不存在

**错误信息**

The custom data does not exist.

**可能原因**

该错误码表示自定义数据不存在，可能原因如下：查询账号的自定义数据时，输入的键名不存在。

**处理步骤**

请使用存在的自定义数据的键名查询。

## 12400003 自定义数据的数量已达上限

**错误信息**

The number of custom data records reaches the upper limit.

**可能原因**

该错误码表示自定义数据的数量已达上限，可能原因如下：设置自定义数据时，目标账号的自定义数据数量已达512。

**处理步骤**

请取消设置操作，或者删除已存在的自定义数据。

## 12400004 令牌数量已达上限

**错误信息**

The number of tokens reaches the upper limit.

**可能原因**

该错误码表示令牌数量已达上限，可能原因如下：添加令牌时，目标账号的令牌数量已达1024。

**处理步骤**

请取消添加操作，或者删除已存在的令牌后再添加。

## 12400005 授权列表已达上限

**错误信息**

The size of the authorization list reaches the upper limit.

**可能原因**

该错误码表示授权列表已达上限，可能原因如下：设置访问/开放授权时，授权列表的大小超过1024。

**处理步骤**

请取消设置操作，或者撤销已存在的访问/开放授权后再设置。