常见错误码

-5

获取Token任务失败。

请检查混淆配置脚本，详情请参见配置混淆脚本。

502

请求连接异常，常见于网络状况不稳定。

建议稍后重试，或联系技术支持解决。

503

流量控制。

1. 平均分配发送速度，尽量控制在华为提供的QPS配额内。QPS配额请查看FAQ。
2. 平均分布推送时间段，不要集中发送。

6003

指纹证书配置不一致。

1. 确认证书指纹端云配置一致。客户端应用打包的证书和在AppGallery Connect网站上给应用配置的“SHA256证书指纹”一致，详情请参见开发准备。
2. HMS Core（APK）会缓存签名文件，需在“应用管理”中找到HMS Core（APK）清理掉缓存数据，然后重新打开您的应用尝试之前的操作。

6004

接口鉴权时，权限不存在。

详情请参见开发准备，检查当前应用是否已经正常打开相关服务。

• 如果您还未申请，请完成开启。

• 如果您已经申请，建议将需要申请的服务行所在开关关闭并重新开启。

该配置项操作后需等待30min左右，同时手机客户端清除HMS Core的缓存后，重启手机测试。

清除HMS Core缓存的方法：依次点击“手机设置 > 应用 > 应用管理 > HMS Core”，进入后，点击存储，将数据和缓存均清除。

80100003

消息结构体错误。

通过响应消息中的提示，请检查消息结构体的参数并修改。

80100016

消息体中带有敏感词汇。

请检查发送消息内容。

80300002

下发消息给指定的用户（Token）报无权限。

1. 登录AppGallery Connect网站，查看推送服务状态是否已开通。
2. 如果您使用OAuth 2.0开放鉴权（客户端模式）获取 Access Token 作为鉴权信息，集成的是SDK 2.0版本，请把获取到的 Access Token 里的转义字符（\）去掉后再进行URL Encode编码（编码常用网址为https://tool.chinaz.com/Tools/urlencode.aspx）。
3. 检查用户的Token与鉴权令牌使用的应用或项目信息是否一致。
4. 如果您的应用在国内推送正常，而在海外服务器返回80300002错误码，则您需要开通海外的Push权益。具体操作：登录AppGallery Connect网站，选择“开发与服务”。在项目列表中找到您的项目，在项目下的应用列表中选择需要开通海外Push权益的应用。前往“项目设置 > API管理”，关闭Push服务，重新启用推送服务。
   说明

   如果只开通推送服务，请您先去应用市场上传一个APK，保存草稿状态即可，否则重新添加的时候您可能无法找到原来的应用。

5. 请检查发送消息体中内容是否有输入错误。
6. 您可先在推送运营平台先推送消息测试下，如果成功，则表明您在调用接口时出错。
7. 在多发送者场景下，请检查接口原型。

80300007

指定的Token无效。

1. 同一个设备，不同应用的Token原则上是不一样，但实际操作时可能误传递同样的值。
2. 客户端应用配置的应用包名、应用ID与AppGallery Connect网站上申请的不一致。
3. 如果您使用OAuth 2.0开放鉴权（客户端模式）获取 Access Token作为鉴权信息，检查获取access_token的URL是否正确；如果是基于服务账号生成鉴权令牌（JSON Web Token）方式，请确认发送的用户Token的应用归属于服务账号对应的项目。
4. 检查消息发送的URL是否正确：

   SDK 2.0 URL：https://api.push.hicloud.com/pushsend.do

   SDK 3.0+ URL：https://push-api.cloud.huawei.com/v1/[clientid]/messages:send

5. 终端设备未安装HMS Core（APK）或已安装的HMS Core（APK）版本过低，请在华为应用市场手动搜索HMS Core安装后再测试。

907122036

没有开通推送权益。

详情请参见开发准备，请检查当前应用是否已经正常打开相关服务。

907122046

Push不可服务。

请联系技术支持解决。

907122047

通用错误码。

请联系技术支持解决。

907122054

Push SDK自动初始化中，请稍后重试操作。

终端设备未安装HMS Core（APK）或已安装的HMS Core（APK）版本过低，请在华为应用市场手动搜索HMS Core安装后再测试。

907122069

不支持子用户操作。

仅终端设备机主可以使用，请切换到机主用户后使用。

907135000

传入的参数错误。

1. 请检查“agconnect-services.json”文件中的app_id、package_name参数是否正确。
2. 请检查“build.gradle”文件中证书签名是否配置。
3. 有可能是HMS Core（APK）缓存导致的，请卸载并重新更新HMS Core（APK），然后断开网络再连接，再打开应用。
4. 建议用华为终端先测试，华为推送会依赖HMS Core（APK），在华为手机上都会预装这个应用，非华为手机上没有预装。

907135003

SDK连接HMS Core（APK）失败。

1. 有可能HMS Core进程被终止或者崩溃了，导致连接失败，请您稍后再试。
2. 有可能是终端设备未安装HMS Core（APK）或已安装的HMS Core（APK）版本过低，请在华为应用市场手动搜索HMS Core安装后再测试。

907135700

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

1. 如果您的应用集成的Push SDK是2.5.2.0版本，请检查一下配置appid的地方，去掉appid=，如果不是2.5.2.0这个版本则无需关注。
2. 在“应用管理”里找到HMS Core（APK）并卸载掉（如果“应用管理”里边查不到，可以点击“应用管理”右上角的图标，通过“显示系统进程”来查找），如果应用正确集成了Push SDK，打开应用后会提示下载HMS Core（APK），安装后再测试，如果没正确集成请在华为应用市场手动搜索HMS Core安装后再测试。
3. 登录AppGallery Connect网站，查看Push服务状态是否已开通。
4. 检查网络状况是否正常，建议您使用移动数据网络测试。

907135701

OpenGW没有配置Scope。

1. 请检查手机网络是否可以正常访问互联网。

2. 请检查当前应用是否已创建并申请相关服务，详情请参见开发准备。