文档管理中心
API参考HMS Core SDK框架错误码

HMS Core SDK框架错误码

展开

错误码

描述

解决方法

ErrorCode.ARGUMENTS_INVALID

907135000

传入的参数错误。

请检查相关的配置信息是否正确。比如:“Manifest”文件中的appid是否配置准确。

ErrorCode.INTERNAL_ERROR

907135001

内部错误,表示内部出现异常且无法恢复。

内部错误,一般情况下重试或进程重新启动可以恢复正确。

ErrorCode.NAMING_INVALID

907135002

服务接口查询错误,指定服务接口不存在或创建服务接口实例失败。

请检查服务接口是否不存在,以及创建服务接口是否失败。

ErrorCode.CLIENT_API_INVALID

907135003

ApiClient对象无效。

检查ApiClient不为null,以及isConnected为true。

ErrorCode.EXECUTE_TIMEOUT

907135004

调用AIDL超时。

检查service是否终止、是否需要重新获取binder等。

ErrorCode.NOT_IN_SERVICE

907135005

当前区域不支持此业务。

请检查用户所在区域是否支持此接口。

ErrorCode.SESSION_INVALID

907135006

HMS Core SDK内部错误,AIDL连接session无效。

一般不会出现此问题。若返回该错误码,请重试,如果多次重试失败,请通过在线提单提交问题。

ErrorCode.DENY_NETWORK

907135007

OOBE(Out-of-box experience,开箱体验)阶段未同意隐私声明,不能访问网络。

OOBE阶段同意隐私声明之后即可正常访问网络。

ErrorCode.GET_SCOPE_ERROR

907135700

调用网关查询应用Scope失败。

  1. 请检查手机网络是否可以正常访问互联网。
  2. 请检查当前应用是否已创建并申请相关服务。

ErrorCode.SCOPE_LIST_EMPTY

907135701

OpenGW没有配置Scope

  1. 请检查手机网络是否可以正常访问互联网。
  2. 请检查当前应用是否已创建并申请相关服务。

ErrorCode.CERT_FINGERPRINT_EMPTY

907135702

OpenGW没有配置指纹证书。

  1. 请检查手机网络是否可以正常访问互联网。
  2. 检查申请相关服务时是否配置了正确的证书指纹。登录AppGallery Connect,单击“开发与服务”,选择需要操作的项目,进入项目页面后选择应用,然后在项目设置 > 常规中检查“SHA256证书指纹”配置的信息是否和根据签名文件生成指纹证书一致,如果不一致请修改。

ErrorCode.PERMISSION_LIST_EMPTY

907135703

OpenGW没有配置Permission。

请检查创建应用时是否启用相关功能,例如使用unionId作为用户表示,需要在创建应用时启用UnionId功能。

ErrorCode.GET_SCOPE_NETWORK_ERROR

907135704

调用网关查询应用Scope失败,并且是服务器返回异常导致的。

  1. 请检查手机网络是否可以正常访问互联网。
  2. 检查能否正常访问:https://api.cloud.huawei.com/rest.php?nsp_svc=nsp.scope.app.get&nsp_fmt=json&type=2&appid=***(其中appid=***填写用户的appid)。

CommonCode.BusInterceptor.PRIVACY_CNCEL_ERROR_CODE

907135705

用户未同意HMS Core的隐私协议。

同意HMS Core的隐私协议。

CommonCode.ErrorCode.KIT_NOT_EXIST

907135900

kit不存在。

某些设备上不支持该kit,请检查对应设备的remoteconfig是否存在该Kit,如不存在则该设备不支持此kit。

CommonCode.ErrorCode.DEVICE_POLICY_INTERCEPTOR

907135901

此设备暂不开启当前功能。

由于业务策略,当前功能在此设备上暂不开放。

StatusCode.AUTH_INFO_NOT_EXIST

6002

应用的鉴权信息不存在。

请检查当前应用是否已创建并已申请相关服务。

StatusCode.CERT_FINGERPRINT_ERROR

6003

证书指纹校验:签名证书指纹错误。

  1. 检查申请相关服务时是否配置了正确的证书指纹。

    安卓:打开应用的APK,将其中“META-INF”文件夹解压出来,得到其中的“CERT.RSA”文件,通过keytool -printcert -file META-INF/CERT.RSA命令打印签名证书信息。

    鸿蒙:多层解压HAP包,最终取到META-INF目录下的*.EC文件,使用JDK的keytool命令查看该EC文件,命令如下:

    keytool -printcert -file {文件名}

  2. 登录AppGallery Connect,单击“开发与服务”,选择需要操作项目,进入项目页面后选择应用,然后在项目设置 > 常规中检查“SHA256证书指纹”配置的信息是否与步骤1的指纹一致。

StatusCode.PERMISSION_NOT_EXIST

6004

接口鉴权:权限不存在,未在华为开发者联盟上申请。

  1. 检查当前应用是否已创建并已申请相关服务。
  2. 清理HMS Core缓存后重试。

StatusCode.PERMISSION_NOT_AUTHORIZED

6005

接口鉴权:未授权。

请检查当前应用是否已创建并已申请相关服务。

StatusCode.PERMISSION_EXPIRED

6006

接口鉴权:授权过期。

请检查当前应用是否已创建并已申请相关服务。

ErrorCode.ERROR_CODE_FRAMEWORK_UPDATING

1200

框架正在升级中,AMS和PMS服务未准备好。

  1. 检查框架升级是否完成,AMS和PMS服务是否准备就绪。
  2. 再次发送请求。

ErrorCode.ERROR_CODE_FRAMEWORK_NOT_READY

1201

AMS和PMS服务未准备好。

  1. 检查AMS和PMS服务是否准备就绪。
  2. 再次发送请求。

ErrorCode.ERROR_CODE_PARAMETER_INVALID

1210

无效参数。

检查传入参数是否正确。

ErrorCode.ERROR_CODE_SESSION_INVALID

1211

无效session。

检查调用方应用身份标识是否正确。

ErrorCode.ERROR_CODE_KIT_NEED_UPDATE

1212

Kit需要升级。

  1. 检查Kit升级是否完成。
  2. 检查应用市场或者本地安装目录是否有高版本Kit。
  3. 再次发送请求。

ERRORCODE.ERROR_CODE_KIT_BREAKER

1213

Kit需要熔断。

熔断状态下,Kit调用失效,不可使用。

ERRORCODE.ERROR_CODE_FRAMEWORK_BREAKER

1214

Framework需要熔断。

熔断状态下,framework调用失效,不可使用。

ERRORCODE.ERROR_CODE_MEMORY_OVER_LIMIT

1215

内存超限。

  1. 检查内存状态是否超限。
  2. 释放内存后重试。

ERRORCODE.ERROR_CODE_AUTH_FAILED

1217

Kit鉴权失败。

  1. 检查Kit是否已创建并已申请相关服务。
  2. 检查Kit申请相关服务时是否配置了正确的证书指纹。

    安卓:打开应用的APK,将其中“META-INF”文件夹解压出来,得到其中的“CERT.RSA”文件,通过keytool -printcert -file META-INF/CERT.RSA命令打印签名证书信息。

    鸿蒙:多层解压HAP包,最终取到META-INF目录下的*.EC文件,使用JDK的keytool命令查看该EC文件,命令如下:

    keytool -printcert -file {文件名}

  3. 登录AppGallery Connect,单击“开发与服务”,选择需要操作的项目,进入项目页面后选择应用,然后在项目设置 > 常规中检查“SHA256证书指纹”配置的指纹是否与步骤2的指纹一致。

ERRORCODE.ERROR_CODE_RUNTIME_AMS

1230

AMS运行时错误。

  1. 请等待几秒重试。
  2. 重启HMS Core。
  3. 应用市场重装HMS Core。

ERRORCODE.ERROR_CODE_RUNTIME_PMS

1240

PMS运行时错误。

  1. 请等待几秒重试。
  2. 重启HMS Core。
  3. 应用市场重装HMS Core。

ERRORCODE.ERROR_CODE_RUNTIME_KAC

1250

KAC运行时错误。

  1. 请等待几秒重试。
  2. 重启HMS Core。
  3. 应用市场重装HMS Core。

ERRORCODE.ERROR_CODE_RUNTIME_OTHER

1260

其他类型错误。

获取相关异常日志,通过在线提单提交问题。

BaseCode.OK

0

成功返回。

-

BaseCode.RESULT_NULL

-1

返回对象为空。

框架返回的result为null, 联系HMS相关同事分析支撑。

BaseCode.PARAM_ERROR

-2

入参为空。

检查BaseAdapter的实例方法,请使用BaseAdapter公开构造函数实例对象。

BaseCode.ACTIVITY_NULL

-3

传入的activity的引用为空。

检查HuaweiApi初始化,构造函数是否传递Activity对象。

BaseCode.NO_SOLUTION

-4

业务没有返回intent或者pending intent。

获取相关异常日志,通过在线提单提交问题。

BaseCode.URI_IS_NULL

-5

header中URI字段获取失败。

检查apiName不为null或空字符串。

BaseCode.TRANSACTION_IS_NUL

-6

header中transaction字段获取失败。

获取transactionId失败或为空,业务排查是否传入。

BaseCode.DATA_NULL_IN_INTENT

-7

on activity result返回的结果中data为空。

框架返回intent为空或者Intent中没有登录升级结果,需提供日志,通过在线提单提交问题。

BaseCode.SOLUTION_GET_RESPONSE_CODE_ERROR

-8

通过intent拉起界面处理结果的时候获取业务执行结果失败。

拉起解决方案失败,CP联系框架同事一起分析。

BaseCode.NO_AVAILABLE_LIB_ERROR

-9

CP没有集成avaliableupdate SDK导致无法resolution。

检查CP是否引用了avaliableupdate SDK。

BaseCode.KPMS_UPDATE_FAILED

-10

KPMS升级Kit失败。

1. 检查网络是否正常。

2. 相关kit是否上架。

3.以上排查都正常时,仍然存在异常,请通过在线提单提交问题。

AvailableCode.SERVICE_MISSING

1

在设备上没有发现HMS Core。

下载安装HMS Core APK。

AvailableCode.SERVICE_VERSION_UPDATE_REQUIRED

2

已经安装的HMS Core过时了。

应用市场更新HMS Core APK版本。

AvailableCode.SERVICE_DISABLED

3

此设备上的HMS Core已经不可用。

1. 应用市场更新HMS Core APK版本。

2. 请按照指导在设置管理里面解除禁用HMS自启动关联启动。

ResolutionResult.INTERNAL_ERROR

8

内部错误。

尝试重试。

AvailableCode.CANCELED

13

用户取消下载、取消安装或者应用使用错误证书。

  1. 下载HMS Core APK过程中请勿点击取消,等待下载完成。
  2. 点击立即安装按钮。
  3. 使用正确的hmsrootcas.bks证书,里面包含052root。

AvailableCode.SERVICE_UNSUPPORTED

21

设备因太老而不能被支持。

请使用高版本设备。

AvailableCode.ERROR_ON_ACTIVITY_RESULT

25

on activity result获取结果失败,表明升级界面非正常关闭导致没有正常返回结果。

框架返回错误,一般不会出现此问题,如果返回该错误码请联系华为技术支持,通过在线提单提交问题。

AvailableCode.ERROR_NO_ACTIVITY

26

没有Activity,无法弹Dialog。

检查初始化HuaweiApi对象,构造函数是否传递Activity对象,只有传入非空的Activity才能弹出Dialog。

AvailableCode.USER_IGNORE_PREVIOUS_POPUP

27

已经有一个升级Dialog在前台。

用户一直没有点击它或者用户点击了下载,但是下载安装动作在1min内没有完成,建议CP重新执行版本检测动作。

AvailableCode.APP_IS_BACKGROUND_OR_LOCKED

28

当前应用在后台或者处于锁屏状态,无法弹出升级页面。

使当前应用处于前台显示状态。

AvailableCode.HMS_IS_SPOOF

29

HMS Core被仿冒。

尝试卸载当前HMS Core应用,应用市场重新下载安装。

AvailableCode.USER_ALREADY_KNOWS_SERVICE_UNAVAILABLE

30

设备未安装HMS Core或者HMS Core版本过低。

安装最新版本的HMS Core。

AvailableCode.CURRENT_SHOWING_SERVICE_UNAVAILABLE

31

重复拉起未安装HMS Core或HMS Core版本过低的提示框。

请确认提示框,安装最新版本的HMS Core。

若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

在 API参考 中进行搜索
请输入您想要搜索的关键词