合作咨询
我们的专家服务团队将竭诚为您提供专业的合作咨询服务
以下仅介绍本模块特有错误码，通用错误码请参考通用错误码。
本文档计划于2026年11月30日后正式下架官网，建议您尽快切换最新版本。
ArkTS错误码
本文导读
说明
1001500001 应用指纹证书校验失败
错误信息
Failed to check the fingerprint of the app bundle.
错误描述
应用指纹证书校验失败。
可能原因
1、client_id未配置或配置的值不正确。
2、应用的指纹证书未配置或配置错误。
3、debug安装包和release安装包的签名存在差异。
处理步骤
1、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
2、检查AGC上应用的指纹证书，详情请见添加公钥指纹。
3、更新app.json5中的versionCode使本地缓存失效后再进行重试。
1001500002 重复请求
错误信息
This error code is reported when a request is already being processed.
错误描述
重复请求。
可能原因
用户多次触发请求Account Kit页面。
处理步骤
应用无需特殊处理。
1001500003 不支持该scopes或permissions
错误信息
The scopes or permissions are not supported.
错误描述
不支持该scopes或者permissions。
可能原因
1、已登录的华为账号不支持授权应用请求的数据。
2、在获取实名信息、实名信息校验、人脸核身等场景下，用户登录的账号为中国境内（不包含中国香港、中国澳门、中国台湾）注册的华为账号，但使用了港澳台通行证进行实名。
3、在实名信息校验、人脸核身等场景下，2in1设备或前置摄像功能异常的设备不支持传入verifyRealName和verifyFace 2个scope进行授权。
4、元服务开发过程中，调AuthorizationWithHuaweiIDRequest接口时传了profile这个scope。
5、在实名信息校验、人脸核身等场景，登录的华为账号是儿童账号。
处理步骤
1、更换或注册一个中国境内（不包含中国香港、中国澳门、中国台湾）的华为账号重新登录授权，如果在一键登录场景下，应用需展示其他登录方式。
2、在获取实名信息、实名信息校验、人脸核身等场景下，引导用户更换使用中国境内（不包含中国香港、中国澳门、中国台湾）身份证实名的华为账号。
3、在实名信息校验、人脸核身等场景下，使用其他前置摄像功能正常的设备授权verifyRealName和verifyFace 2个scope。
4、元服务开发过程中，不使用AuthorizationWithHuaweiIDRequest接口获取用户头像，参考元服务开发指南中获取头像章节获取用户头像。
5、更换或注册一个中国境内（不包含中国香港、中国澳门、中国台湾）的成人华为账号，重新触发接口。
1001500004 已登录的华为账号不支持该功能
错误信息
The account does not support this function.
错误描述
已登录的华为账号不支持该功能。
可能原因
已登录的华为账号注册地不在中国境内（不包含中国香港、中国澳门、中国台湾）或该账号为儿童账号，不支持调用获取手机号一致性状态接口。
处理步骤
更换或注册一个注册地为中国境内（不包含中国香港、中国澳门、中国台湾）的非儿童账号，重新触发该接口。
1001500005 功能被限制调用
错误信息
This function is restricted from being called.
错误描述
功能被限制调用。
可能原因
获取手机号一致性接口getMobileNumberConsistency在24h内被调用超过50次。
处理步骤
1、应用需要控制手机号一致性接口的调用次数，保证24h内不超过50次。
2、若开发者调测过程中出现该错误码，可通过重启设备恢复。
1001502001 用户未登录华为账号
错误信息
The user has not logged in with HUAWEI ID.
错误描述
用户未登录华为账号。
可能原因
用户事先未登录华为账号。
处理步骤
如需引导用户登录，可调用LoginWithHuaweiIDRequest，将forceLogin参数设置为true拉起登录页面引导用户登录，或引导用户在系统设置中登录华为账号。
1001502002 应用未授权
错误信息
The application is not authorized.
错误描述
应用未授权。
可能原因
1、调用AuthorizationWithHuaweiIDRequest且forceAuthorization参数设置为false的场景，用户未对应用授权。
2、idValue未按照getMobileNumberConsistency接口中的ConsistencyRequest正确传入或用户已对应用取消授权。
3、idValue未按照getHuaweiIDState接口中的StateRequest正确传入或用户已对应用取消授权。
处理步骤
1、如需引导用户授权，可调用AuthorizationWithHuaweiIDRequest，通过将forceAuthorization参数设置为true（不设置默认为true）拉起用户授权页面引导用户授权。
2、参考ConsistencyRequest中的idValue正确方式获取或重新授权。
3、参考StateRequest中的idValue正确方式获取或重新授权。
1001502003 输入参数值无效
错误信息
Invalid input parameter value.
错误描述
输入参数值无效。
可能原因
1、接口传参异常，如调用授权API（AuthorizationWithHuaweiIDRequest）时scope和permission都未传、client_id未配置或配置错误等。
2、如果是一键登录场景，则可能是传入的匿名手机号不正确，或是未调用授权API（AuthorizationWithHuaweiIDRequest）获取匿名手机号。
处理步骤
1、检查接口参数。
2、如果是上述原因2导致，需要传通过授权API（AuthorizationWithHuaweiIDRequest）获取到的匿名手机号。
3、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
1001502005 网络异常
错误信息
Network error.
错误描述
网络异常。
可能原因
设备未联网。
处理步骤
检查网络连接。
1001502009 内部错误
错误信息
Internal error.
错误描述
内部错误。
可能原因
华为账号服务器错误、调用了当前设备不支持的API或其他内部错误等。
处理步骤
1、重启设备后重试。
2、请检查当前设备是否支持调用该API，建议先使用canIUse判断当前设备是否支持该API，再进行调用。
3、若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。
1001502012 用户取消授权
错误信息
The user canceled the authorization.
错误描述
用户取消授权。
可能原因
用户取消了授权操作。
处理步骤
应用无需特殊处理。
1001502014 应用未申请scopes或permissions权限
错误信息
The app does not have the required scopes or permissions.
错误描述
应用未申请scopes或permissions权限。
可能原因
scopes或permissions没有申请权限。
处理步骤
申请对应权限，请见配置scope权限章节。
1001600001 网络未连接
错误信息
The network is unavailable.
错误描述
网络未连接。
可能原因
网络未连接或连接不好。
处理步骤
检查网络是否连接好。
1001600002 用户未登录华为账号
错误信息
The user has not logged in with HUAWEI ID.
错误描述
用户未登录华为账号。
可能原因
用户未事先登录华为账号。
处理步骤
如需引导用户登录，可调用LoginWithHuaweiIDRequest，将forceLogin参数设置为true拉起登录页面引导用户登录，或引导用户在系统设置中登录华为账号。
1001600003 应用指纹证书校验失败
错误信息
Failed to check the fingerprint of the application bundle.
错误描述
应用指纹证书校验失败。
可能原因
1、client_id未配置或配置的值不正确。
2、应用的指纹证书未配置或配置错误。
处理步骤
1、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
2、检查AGC上应用的指纹证书，详情请见添加公钥指纹。
1001600004 应用未申请对应permissions权限
错误信息
The application does not have the required permissions.
错误描述
应用未申请对应permissions权限。
可能原因
未申请对应接口permissions权限。
处理步骤
确认对应接口permissions是否已申请。
1001600005 用户取消当前操作
错误信息
The user canceled the current operation.
错误描述
用户取消当前操作。
可能原因
用户取消了当前操作流程。
处理步骤
应用无需特殊处理。
1001600006 在设备上未获取到对应的验证要素
错误信息
The requested verification factors are unavailable on the device.
错误描述
在设备上未获取到对应的验证要素。
可能原因
用户二次验证中未配置验证要素，如手机号、安全手机号、邮箱、安全邮箱。
处理步骤
引导用户到系统设置>华为账号中心>个人信息或系统设置>华为账号中心>账号安全对验证要素进行配置。
1001600007 内部错误
错误信息
Internal error.
错误描述
内部错误。
可能原因
华为账号服务器错误或其他内部错误等。
处理步骤
1、重启设备后重试。
2、若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。
1008100001 内部错误
错误信息
Internal error.
错误描述
内部错误。
可能原因
华为账号服务器错误或其他内部错误等。
处理步骤
1、重启设备后重试。
2、若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。
1008100002 网络未连接
错误信息
The network is unavailable.
错误描述
网络未连接。
可能原因
网络未连接或连接不好。
处理步骤
检查网络是否连接好。
1008100003 用户未登录华为账号
错误信息
The user has not signed in with HUAWEI ID.
错误描述
用户未登录华为账号。
可能原因
用户未事先登录华为账号。
处理步骤
如需引导用户登录，可调用LoginWithHuaweiIDRequest，将forceLogin参数设置为true拉起登录页面引导用户登录，或引导用户在系统设置中登录华为账号。
1008100004 应用指纹证书校验失败
错误信息
Failed to check the fingerprint of the app bundle.
错误描述
应用指纹证书校验失败。
可能原因
1、client_id未配置或配置的值不正确。
2、应用的指纹证书未配置或配置错误。
处理步骤
1、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
2、检查AGC上应用的指纹证书，详情请见添加公钥指纹。
1008100005 应用未申请对应permissions权限
错误信息
The app does not have the required permissions.
错误描述
应用未申请对应permissions权限。
可能原因
未申请对应接口permissions权限。
处理步骤
确认对应接口permissions是否已申请，申请步骤参见开发前提第2点。
1008100006 用户未完成操作就退出了收货地址管理服务
错误信息
The user quits the shipping address management service without finishing.
错误描述
用户未完成操作就退出了收货地址管理服务。
可能原因
用户未完成收货地址选择操作，取消或者关闭了收货地址管理服务页面。
处理步骤
应用无需特殊处理。
1008100007 已登录的华为账号不支持收货地址管理服务
错误信息
The shipping address management service does not support the HUAWEI ID that is already signed in.
错误描述
已登录的华为账号不支持收货地址管理服务。
可能原因
已登录的华为账号注册地（如海外账号）不支持收货地址管理服务。
处理步骤
引导用户更换或注册一个中国境内（不包含中国香港、中国澳门、中国台湾）的华为账号重新登录，或使用其他方式获取收货地址。
1010060001 用户取消发票服务
错误信息
The operation was canceled by the user.
错误描述
用户取消发票服务。
可能原因
操作未完成用户就取消了操作。
处理步骤
应用无需特殊处理。
1010060002 系统内部错误
错误信息
System internal error.
错误描述
系统内部错误。
可能原因
华为账号服务器错误或其他内部错误等。
处理步骤
1、重启设备后重试。
2、若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。
1010060003 应用指纹证书校验失败
错误信息
Failed to check the fingerprint of the app bundle.
错误描述
应用指纹证书校验失败。
可能原因
1、client_id未配置或配置的值不正确。
2、应用的指纹证书未配置或配置错误。
处理步骤
1、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
2、检查AGC上应用的指纹证书，详情请见添加公钥指纹。
1010060004 接口调用过于频繁
错误信息
Too frequent API calls.
错误描述
接口调用过于频繁。
可能原因
接口访问间隔过短。
处理步骤
请控制接口调用频度。
1010060005 网络连接错误
错误信息
Network connection error.
错误描述
网络连接错误。
可能原因
网络未连接或连接不好。
处理步骤
检查网络是否连接好。
1010060006 用户未登录华为账号
错误信息
The HUAWEI ID is not signed in.
错误描述
用户未登录华为账号。
可能原因
用户未事先登录华为账号。
处理步骤
如需引导用户登录，可调用LoginWithHuaweiIDRequest，将forceLogin参数设置为true拉起登录页面引导用户登录，或引导用户在系统设置中登录华为账号。
1010060007 创建发票抬头失败，发票抬头已存在
错误信息
Failed to create a invoice title because the title already exists.
错误描述
创建发票抬头失败，发票抬头已存在。
可能原因
发票抬头已存在。
处理步骤
应用无需特殊处理。
1010060008 华为账号不支持发票服务
错误信息
The invoice service does not support the logged HUAWEI ID.
错误描述
华为账号不支持发票服务。
可能原因
账号可能为海外账号。
处理步骤
引导用户更换或注册一个中国境内（不包含中国香港、中国澳门、中国台湾）的华为账号重新登录，或使用其他方式获取发票抬头。
1005300001 用户未同意协议
错误信息
The user did not accept the agreement.
错误描述
用户未同意协议。
可能原因
使用华为账号登录组件时，未设置协议状态为ACCEPTED。
处理步骤
需要用户手动同意协议。
1005300002 用户未点击“华为账号一键登录”按钮
错误信息
The user did not click the HUAWEI ID login button.
错误描述
用户未点击“华为账号一键登录”按钮。
可能原因
开发者绕过点击“华为账号一键登录”按钮，直接调用continueLogin接口。
处理步骤
仅通过点击“华为账号一键登录”按钮，在拉起的协议弹框上点击同意并登录按钮时才调用continueLogin接口。
1009900002 未成年人模式未开启
错误信息
The minors mode is not enabled.
错误描述
未成年人模式未开启。
可能原因
未成年人模式未开启就调用验证密码请求。
处理步骤
1009900003 用户取消操作
错误信息
The user canceled the operation.
错误描述
用户取消操作。
可能原因
用户主动点击页面关闭按钮
处理步骤
处理用户取消的逻辑。
1009900005 未成年人模式已经开启
错误信息
The minors mode is already on.
错误描述
未成年人模式已经开启。
可能原因
未成年人模式已经开启，重复调用开启未成年人模式接口。
处理步骤
调用getMinorsProtectionInfoSync()或getMinorsProtectionInfo()判断当前未成年人模式的状态，如果未成年人模式是关闭状态，再调用接口。
1009900006 未成年人模式已经关闭
错误信息
The minors mode is already off.
错误描述
未成年人模式已经关闭。
可能原因
未成年人模式已经关闭，重复调用关闭未成年人模式接口。
处理步骤
调用getMinorsProtectionInfoSync()或getMinorsProtectionInfo()判断当前未成年人模式的状态，如果未成年人模式是开启状态，再调用接口，否则无需重复调用。
1009900007 不支持的账号
错误信息
Unsupported HUAWEI ID.
错误描述
不支持的账号。
可能原因
账号可能为海外账号。
处理步骤
登录中国境内（不包含中国香港、中国澳门、中国台湾）账号。
1009900011 服务不可用
错误信息
Service not available.
错误描述
服务不可用。
可能原因
设备进入隐私空间。
处理步骤
开发者可提醒用户进入“设置”>“隐私和安全”>“隐私空间”退出隐私空间，或者构建自己的未成年人模式。
1002500001 网络未连接
错误信息
The network is unavailable.
错误描述
网络未连接。
可能原因
网络未连接或连接不好。
处理步骤
检查网络是否连接好。
1002500002 用户未登录华为账号
错误信息
The user has not logged in with HUAWEI ID.
错误描述
用户未登录华为账号。
可能原因
用户未事先登录华为账号。
处理步骤
如需引导用户登录，可调用LoginWithHuaweiIDRequest，将forceLogin参数设置为true拉起登录页面引导用户登录，或引导用户在系统设置中登录华为账号。
1002500003 应用指纹证书校验失败
错误信息
Failed to check the fingerprint of the application bundle.
错误描述
应用指纹证书校验失败。
可能原因
1、client_id未配置或配置的值不正确。
2、应用的指纹证书未配置或配置错误。
处理步骤
1、检查module type为entry的模块下module.json5中的client_id是否配置或配置的值是否正确，请参考配置Client ID。
2、检查AGC上应用的指纹证书，详情请见添加公钥指纹。
1002500004 应用未申请对应permissions权限
错误信息
The application does not have the required permissions.
错误描述
应用未申请对应permissions权限。
可能原因
未申请对应接口permissions权限。
处理步骤
确认对应接口permissions是否已申请，申请步骤参见对应场景下的开发前提。
1002500005 用户取消验证
The user canceled the verification of the HUAWEI ID.
错误描述
用户取消验证。
可能原因
用户取消了验证操作流程。
处理步骤
应用无需特殊处理。
1002500006 内部错误
错误信息
Internal error.
错误描述
内部错误。
可能原因
华为账号服务器错误、调用了当前设备不支持的API或其他内部错误等。
处理步骤
1、重启设备后重试。
2、请检查当前设备是否支持调用该API，建议先使用canIUse判断当前设备是否支持该API，再进行调用。
3、若您的问题仍无法解决，请通过在线提单提交问题，华为支持人员会及时处理。
1002500008 该华为账号不支持实名验证
错误信息
Real-name verification is not supported for the HUAWEI ID.
错误描述
该华为账号不支持实名验证。
可能原因
使用的华为账号注册地非中国境内（不包含中国香港、中国澳门、中国台湾）。
处理步骤
更换注册地为中国境内（不包含中国香港、中国澳门、中国台湾）账号再操作。
1002500009 实名渠道验证失败
错误信息
Real-name channel verification failed.
错误描述
实名渠道验证失败。
可能原因
1、实名认证渠道号传入错误。
2、实名认证渠道验证出错。
处理步骤
1、请检查实名认证渠道号是否正确。
2、请通过在线提单提交问题，华为支持人员会及时处理。
1002500011 您的面部与作为身份证明的面部图像不匹配
错误信息
Your face does not match your facial image as proof of identity.
错误描述
您的面部与作为身份证明的面部图像不匹配。
可能原因
您的面部与作为身份证明的面部图像不匹配。
处理步骤
引导用户重新验证人脸。
1002500012 未查询到实名信息
错误信息
No real-name information is found for the HUAWEI ID.
错误描述
未查询到实名信息。
可能原因
账号未实名。
处理步骤
引导用户到系统设置>华为账号中心>个人信息>实名认证条目下完成实名认证。
1002500013 姓名和身份证号码不匹配
错误信息
Your name and ID number do not match.
错误描述
姓名和身份证号码不匹配。
可能原因
1、用户输入有误。
2、用户可能最近变更了户口，或挂失身份证并补发了新卡，但该身份信息尚未与公安部同步。
处理步骤
1、重新输入姓名身份证号后重试。
2、如是原因2引起，建议用户隔段时间后再重试。
1002500014 实名认证尝试次数过多
错误信息
Too many real-name verification attempts.
错误描述
实名认证尝试次数过多。
可能原因
实名认证尝试次数过多。
处理步骤
24小时后重试。
1002500015 参数verificationToken不合法
错误信息
The verificationToken parameter is incorrectly set.
错误描述
参数verificationToken不合法。
可能原因
参数verificationToken不合法。
处理步骤
重新获取正确的verificationToken后重试。
1002500016 此设备不支持此API
错误信息
This device does not support this API.
错误描述
此设备不支持此API。
可能原因
在人脸核身场景下设备前置摄像头不可用。
处理步骤
修复该设备的前置摄像故障或更换前置摄像功能正常的设备后重试。