推送服务的错误码由HMS Core SDK框架错误码与HMS Core Push 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失败。 |
|
ErrorCode.SCOPE_LIST_EMPTY | 907135701 | OpenGW没有配置Scope。 |
|
ErrorCode.CERT_FINGERPRINT_EMPTY | 907135702 | OpenGW没有配置指纹证书。 |
|
ErrorCode.PERMISSION_LIST_EMPTY | 907135703 | OpenGW没有配置Permission。 | 请检查创建应用时是否启用相关功能，例如使用unionId作为用户表示，需要在创建应用时启用UnionId功能。 |
ErrorCode.GET_SCOPE_NETWORK_ERROR | 907135704 | 调用网关查询应用Scope失败，并且是服务器返回异常导致的。 |
|
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 | 证书指纹校验：签名证书指纹错误。 |
|
StatusCode.PERMISSION_NOT_EXIST | 6004 | 接口鉴权：权限不存在，未在华为开发者联盟上申请。 |
|
StatusCode.PERMISSION_NOT_AUTHORIZED | 6005 | 接口鉴权：未授权。 | 请检查当前应用是否已创建并已申请相关服务。 |
StatusCode.PERMISSION_EXPIRED | 6006 | 接口鉴权：授权过期。 | 请检查当前应用是否已创建并已申请相关服务。 |
ErrorCode.ERROR_CODE_FRAMEWORK_UPDATING | 1200 | 框架正在升级中，AMS和PMS服务未准备好。 |
|
ErrorCode.ERROR_CODE_FRAMEWORK_NOT_READY | 1201 | AMS和PMS服务未准备好。 |
|
ErrorCode.ERROR_CODE_PARAMETER_INVALID | 1210 | 无效参数。 | 检查传入参数是否正确。 |
ErrorCode.ERROR_CODE_SESSION_INVALID | 1211 | 无效session。 | 检查调用方应用身份标识是否正确。 |
ErrorCode.ERROR_CODE_KIT_NEED_UPDATE | 1212 | Kit需要升级。 |
|
ERRORCODE.ERROR_CODE_KIT_BREAKER | 1213 | Kit需要熔断。 | 熔断状态下，Kit调用失效，不可使用。 |
ERRORCODE.ERROR_CODE_FRAMEWORK_BREAKER | 1214 | Framework需要熔断。 | 熔断状态下，framework调用失效，不可使用。 |
ERRORCODE.ERROR_CODE_MEMORY_OVER_LIMIT | 1215 | 内存超限。 |
|
ERRORCODE.ERROR_CODE_AUTH_FAILED | 1217 | Kit鉴权失败。 |
|
ERRORCODE.ERROR_CODE_RUNTIME_AMS | 1230 | AMS运行时错误。 |
|
ERRORCODE.ERROR_CODE_RUNTIME_PMS | 1240 | PMS运行时错误。 |
|
ERRORCODE.ERROR_CODE_RUNTIME_KAC | 1250 | KAC运行时错误。 |
|
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 | 用户取消下载、取消安装或者应用使用错误证书。 |
|
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。 |
错误码 | 现象描述 | 解决方法 |
|---|---|---|
-5 | 获取Token任务失败。 | 请检查混淆配置脚本，详情请参见配置混淆脚本。 |
-10 | KPMS升级Kit失败。 | HMS Core升级失败，请通过在线提单提交问题。 |
907122030 | 没有Token。 | 请检查调用申请Token方法的入参是否正确。 |
907122031 | 当前网络不可用。 | 请检查网络连接情况。 |
907122032 | Token失效。 | |
907122034 | 订阅的主题数超限（2000）。 | 请删除不必要的主题，详情可参见取消订阅主题。 |
907122035 | 主题订阅失败。 | 建议稍后重试，或联系技术支持解决。 |
907122036 | 没有开通推送服务权益。 | 详情请参见开发准备，检查当前应用是否已经正常打开相关服务。 |
907122037 | 申请Token失败。 | 建议稍后重试，或联系技术支持解决。 |
907122038 | 应用未选择存储位置或者存储位置非法。 | 请为您的应用设置正确的数据处理位置，详情请参见设置默认数据处理位置。 |
907122039 | 多发送者场景下发送者没有权限。 | 请参见目标应用为发送者配置权限指导。 |
907122041 | 消息体大小超过了允许的最大值（1KBytes）。 | 请检查您发送的消息体大小。 |
907122042 | 发送的消息中携带了无效参数。 | 请检查消息体的参数是否合法。 |
907122043 | 本消息因发送消息数达到上限而丢弃。 | 请减少发送消息的数量。 |
907122044 | 在成功发送给应用服务器之前，本消息因过期而丢弃。 | 请重新设置消息缓存时间，支持设置最大值为15天。 |
907122045 | 未知错误。 | 系统内部异常，您无法单独处理，请联系技术支持。 |
907122047 | Push通用错误码。 | 错误场景较多，请联系技术支持具体定位。 |
907122048 | HMS Core（APK）无法连接Push Kit。 | 请联系技术支持。 |
907122049 | 当前系统EMUI版本过低或者推送服务版本过低导致能力不可使用。 | 请升级推送服务（APK）的版本，若升级后还未解决问题，请尝试更换高版本EMUI的终端设备。 |
操作不能在主线程中。 | 请新建一个线程，在新线程中调用具体的方法。 | |
907122051 | 设备证书认证失败。 | 请联系技术支持。 |
907122052 | 绑定服务失败。 | 建议稍后重试，或联系技术支持解决。 |
907122053 | 申请Token失败，不允许跨区申请Token。 | 请检查是否存在跨数据处理位置申请Token。 |
907122054 | Push SDK自动初始化中，请稍后重试操作。 | 终端设备未安装HMS Core（APK）或已安装的HMS Core（APK）版本过低，请在华为应用市场手动搜索HMS Core安装后再测试。 |
907122055 | 系统繁忙，请重试。 | 请稍后重试。 |
907122056 | 发送上行消息失败。 | 请稍后重试发送上行消息。 |
907122057 | 发送上行消息时构造对象入参不正确。 | 请确认RemoteMessage.Builder构造对象入参为“push.hcm.upstream”。 |
907122058 | 应用发送的上行消息缓存数超过缓存阈值（20）而丢弃。 | 请稍后重试。 |
907122059 | 由于网络不可用等原因应用发送的上行消息暂时处于缓存状态。 | 请稍后重试。 |
907122060 | 应用服务器不在线。 | 请稍后重试。 |
907122061 | 应用调用接口频率过高被流控。 | 请减少调用接口的频率。 |
907122064 | “agconnect-services.json”文件里缺少projectId字段。 | 请登录AppGallery Connect网站，点击“我的项目”，在项目列表中找到您的项目，重新下载“项目设置”里的“agconnect-services.json”文件。 |
907122065 | 智能手表、VR、路由器应用申请Token失败。 | 暂不支持第三方的智能手表、VR、路由器应用推送。 |
907122066 | 无法获取华为帐号信息。 |
|
907122067 | 添加的profile数量超过最大值（10）。 | 请清除不再使用的profile，详情请参见删除profile。 |
907122070 | 设备安装的推送服务版本过低。 | 请升级您设备上安装的推送服务应用。 |
907122072 | HMSCore版本过低。 | 请升级您设备上安装的HMS Core应用。 |
907122101 | 获取推送服务的Token失败。 | 请联系技术支持。 |
907122102 | 删除推送服务的Token失败。 | 请联系技术支持。 |
907122103 | 推送服务SDK内部发生错误。 | 请联系技术支持。 |
907122104 | 获取域名失败。 | 建议稍后重试，或联系技术支持解决。 |
907122105 | 构建申请Token的JSON消息体失败。 | 建议稍后重试，或联系技术支持解决。 |
907122073 | 消息订阅操作的频率过高 | 请减少消息订阅的频率。 |
907122074 | 应用的通知开关处于关闭状态 | 请检查应用系统通知开关。 |
907122075 | 消息订阅操作被拒绝 | 当前消息订阅操作被拒绝，已有订阅业务正在执行，请稍后重试。 |
907122076 | 消息订阅模板ID错误 | 请检查消息订阅模板ID是否正确。 |
907122077 | 没有权限发送该消息模板 | 请检查您应用的类别和发送消息模板的类型。 |
若您的问题仍无法解决，请联系技术支持描述问题，相关技术支持人员会及时处理您的问题。