| 类型 | 返回码常量 | 返回码值 | 返回码说明 | 处理建议 |
HMSAgent 错误码 | HMSAgent.AgentResultCode.HMSAGENT_SUCCESS | 0 | 成功 | |
HMSAgent.AgentResultCode.HMSAGENT_NO_INIT | -1000 | ● 没有成功调用init接口。 ● HMS Agent和HMS SDK的版本不匹配。 | 1、在application的onCreate方法里检查是否已经有调用init接口的代码。 2、请务必保证HMS Agent的主版本号与使用的HMS SDK 版本一致。 | |
HMSAgent.AgentResultCode.NO_ACTIVITY_FOR_USE | -1001 | 接口调用过程中需要使用Activity提示用户，但是HMS SDK没有获取到Activity。 | 请应用检查当前Activity是否有异常退出。 | |
HMSAgent.AgentResultCode.RESULT_IS_NULL | -1002 | HMSSDK返回异常，接口的返回结果为空。 | 请联系华为技术支持定位。 | |
HMSAgent.AgentResultCode.STATUS_IS_NULL | -1003 | HMSSDK返回异常，接口状态为空。 | 请联系华为技术支持定位。 | |
HMSAgent.AgentResultCode.START_ACTIVITY_ERROR | -1004 | Activity拉起异常，在Manifest文件中没有定义。 | 检查Activity是否已在Manifest文件中注册。 | |
HMSAgent.AgentResultCode.ON_ACTIVITY_RESULT_ERROR | -1005 | 接口调用过程中onActivityResult非OK，可能是异常中断（关机、程序崩溃等）。 | 向用户给出提示，如果是支付过程中返回此错误码需定时调用getOrderDetail查询订单当前的支付状态，1天后仍未支付成功则作为支付失败处理。 | |
HMSAgent.AgentResultCode.REQUEST_REPEATED | -1006 | 重复调用接口。 | 请勿在上一个接口还未返回结果前再次调用接口。 | |
HMSAgent.AgentResultCode.APICLIENT_TIMEOUT | -1007 | HMS Core（APK）连接超时。 | 请检查HMS Core（APK）状态和网络情况，并重新调用connect接口尝试重新连接，如仍然超时请联系华为技术支持定位。 | |
HMS SDK框架错误码 | ErrorCode.ARGUMENTS_INVALID | 907135000 | 传入的参数错误。 | 请检查相关的配置信息是否正确。比如：Manifest文件中的appid是否配置准确。 |
ErrorCode.INTERNAL_ERROR | 907135001 | 内部错误，表示内部出现异常且无法恢复。 | 内部接口出现异常，请联系华为技术支持定位。 | |
ErrorCode.NAMING_INVALID | 907135002 | HMS SDK内部错误，服务不存在，调用的接口不存在。 | 请联系华为技术支持检查HMS SDK Agent构建HUAWEIApiClient时设置的API是否正确。 | |
ErrorCode.CLIENT_API_INVALID | 907135003 | HMS SDK内部错误，ApiClient对象无效。 | 一般不会出现此问题，如果返回该错误码请联系华为技术支持。 | |
ErrorCode.EXECUTE_TIMEOUT | 907135004 | HMS SDK内部错误，调用AIDL超时。 | 一般不会出现此问题，如果返回该错误码请联系华为技术支持。 | |
ErrorCode.NOT_IN_SERVICE | 907135005 | 当前区域不支持此业务。 | 请检查用户所在区域是否支持此接口。 | |
ErrorCode.SESSION_INVALID | 907135006 | HMS SDK内部错误，AIDL连接session无效。 | 一般不会出现此问题，如果返回该错误码请联系华为技术支持。 | |
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、检查申请相关服务时配置了正确的证书指纹。登录开发者联盟，点击“管理中心”，在“应用服务”中点击需要检查证书指纹应用的服务，如“帐号”、“支付”。 在“产品服务列表”界面点击应用名称，检查“SHA256证书指纹”配置的信息是否和根据签名文件生成指纹证书一致，如果不一致请修改。 3、如果检查都正确，请联系华为技术支持。 | |
ErrorCode.PERMISSION_LIST_EMPTY | 907135703 | OpenGW没有配置Permission。 | 请检查创建应用时是否启用相关功能，例如使用unionId作为用户表示，需要在创建应用时启用UnionId功能。 | |
HMS_VERSION_CONFIGER_INVALID | 907135007 | Manifest文件中配置的HMS Core（APK）版本号错误，不满足当前接口要求的HMS Core（APK）的最低版本号。 | 1、在Manifest文件的application节点下检查是否配置了"com.huawei.hms.version"信息。 2、检查"com.huawei.hms.version"信息中配置的value是否为HMS Core（APK）主版本号，例如2.6.1.319需要写成2.6.1。 | |
CommonCode.StatusCode.API_NOT_SPECIFIED | 1002 | HMS SDK内部错误，初始化client时没有添加HuaweiId API。 | 一般不会出现此问题，如果返回该错误码请联系华为技术支持定位。 | |
StatusCode.AUTH_INFO_NOT_EXIST | 6002 | 应用的鉴权信息不存在。 | 请检查当前应用是否已创建并已申请相关服务。如果检查都正确，请联系华为技术支持定位。 | |
StatusCode.CERT_FINGERPRINT_ERROR | 6003 | 证书指纹校验：签名证书指纹错误。 | 1、检查申请相关服务时配置了正确的证书指纹。 打开应用的APK，将其中META-INF文件夹解压出来，得到其中的CERT.RSA文件，通过keytool -printcert -file META-INF/CERT.RSA命令打印签名证书信息。 登录开发者联盟，点击“管理中心”，在“应用服务”中点击需要检查证书指纹应用的服务，如“帐号”、“支付”。在“产品服务列表”界面点击应用名称，检查“SHA256证书指纹”配置的信息。 检查两边指纹是否一致。 2、如果检查都正确，请联系华为方支持人员。 | |
StatusCode.PERMISSION_NOT_EXIST | 6004 | 接口鉴权：权限不存在，未在华为开发者联盟上申请。 | 1、检查当前应用是否已创建并已申请相关服务。 2、检查Manifest文件中应用包名是否配置正确。 3、清理HMS Core（APK）缓存后重试。 4、如果问题仍未解决，请联系华为 技术支持定位。 | |
StatusCode.PERMISSION_NOT_AUTHORIZED | 6005 | 接口鉴权：未授权。 | 请检查当前应用是否已创建并已申请相关服务。如果检查都正确，请联系华为技术支持定位。 | |
StatusCode.PERMISSION_EXPIRED | 6006 | 接口鉴权：授权过期。 | 请检查当前应用是否已创建并已申请相关服务。如果检查都正确，请联系华为技术支持定位。 | |
ConnectionResult.SERVICE_MISSING | 1 | 设备上未安装HMS Core（APK）。 | 需要在设备中安装HMS Core（APK）。 | |
ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED | 2 | 设备上安装的HMS Core（APK）需要升级。 | 需要用户升级设备的HMS Core（APK）。 | |
ConnectionResult.SERVICE_DISABLED | 3 | 设备上的HMS Core（APK）已经不可用。 | 说明HMS Core（APK）被禁用了，请到设备系统设置中启用。 | |
ConnectionResult.BINDFAIL_RESOLUTION_REQUIRED | 6 | HMS SDK内部错误，aidl绑定失败。 | 一般不会出现此问题，如果返回该错误码请检查HMS Core（APK）权限是否被禁（自启动、关联启动）。 | |
ConnectionResult.INTERNAL_ERROR | 8 | 发生内部错误。 | 内部接口出现异常，请联系华为方支持人员。 | |
ConnectionResult.SERVICE_INVALID | 9 | 设备上安装的HMS Core（APK）不是真实的。 | 设备上安装的HMS Core（APK）应用有伪造嫌疑，请确认HMS Core（APK）应用来源是否正确。 | |
ConnectionResult.DEVELOPER_ERROR | 10 | HMS SDK内部错误，aidl连接成功但是获取不到aidl句柄，一般是开发配置错误导致。 | 一般不会出现此问题，如果返回该错误码请联系华为技术支持定位。 | |
ConnectionResult.CANCELED | 13 | HMS Core（APK）版本过低时，弹出升级对话框，此时用户取消了升级。 | 需要用户升级HMS Core（APK）。 | |
ConnectionResult.TIMEOUT | 14 | HMS Core（APK）版本过低时，弹出升级引导，在下载升级包时超时了。 | 请检查网络，确保下载HMS Core（APK）升级包成功。 | |
ConnectionResult.SERVICE_UNSUPPORTED | 21 | 设备版本因太老而不支持。 | 设备版本太低，HMS Core(APK)支持的android最低版本为Android4.0.3。 |