HMS Core[推送服务](https://developer.huawei.com/consumer/cn/hms/huawei-pushkit?ha_source=hms1)支持开发者使用HTTPS协议接入Push服务端，可以从服务器发送下行消息给终端设备。这篇文章汇总了服务端下发消息最常见的6个错误码，并提供了原因分析和解决方法，有遇到类似问题的开发者们快了解一下吧。

### 错误码一：80200001，" Oauth认证错误"

#### 原因分析：

1.	下发消息未添加Authorization请求参数或值为空。

![](https://oscimg.oschina.net/oscnet/up-71c100c9a3ae713d5662056d4b018cf3f78.png)
 
2. 应用A的APPID申请的Access Token，却用于给应用B推送消息，也会出现此错误码。

![](https://oscimg.oschina.net/oscnet/up-0e839c7e005739333ca5bdc4c4d419db50e.png)
 
申请Access Token

![](https://oscimg.oschina.net/oscnet/up-f56e34ec2b2854202f70429a89ba53a6d41.png)
 
 ![](https://oscimg.oschina.net/oscnet/up-b4f7368cb3a0ef1d7af3871b985108a5d8f.png)
 
下发消息

#### 解决方法：

1. 排查请求HTTP头中是否有入参Authorization请求参数。Authorization获取方式可[参考文档](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/oauth2-0000001212610981?ha_source=hms1)、下行消息API可[参考文档](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/https-send-api-0000001050986197?ha_source=hms1)。

2. 获取Access Token使用的APPID和下发消息使用的APPID需要保持一致。

### 错误码二：80300007，"Token无效错误"

#### 原因分析：

1.	token不合法，token中多或少了字符，例如下图中多了个空格。
 
 ![](https://oscimg.oschina.net/oscnet/up-4de629516085789be3c36a1c9218c2cfd27.png)
 
2.	给应用A下发消息，token却是应用B的，这种情况也是原因之一。

![](https://oscimg.oschina.net/oscnet/up-121ff3ba5a24336835ab60664dd5603a4f3.png)
 
#### 解决方法：

1. 检查token参数是否正确；

2. 确保下发消息使用的token，是获取于目标应用的

### 错误码三：80300010，"消息体中的Token数量不符合默认值"

#### 原因分析：

1.	开发者将“message”字段拼写错误，示例图中message字段结尾多了 'r'；

2.	token位置不正确，字段结构问题；

3.	下发的token数量超过了限制，或token为空。

![](https://oscimg.oschina.net/oscnet/up-93d281d7593d0d529735c6ffc3884e315d4.png)
 
#### 解决方法：

1.	确保message、token字段写入正确；

2.	message字段包含token，与 "android"同级；

![](https://oscimg.oschina.net/oscnet/up-fc3c4792669b12301991a12786c0990607b.png)
 
3.	token的数量应在1-1000个，确认token参数的数量，参考字段结构及说明请[参考文档](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-References/https-send-api-0000001050986197?ha_source=hms1)。

### 错误码四：80200003，"Oauth Token过期"

#### 原因分析：

1. Authorization请求参数值中的Access Token已过期

2. 请求参数值不正确，多或少了其他字符。
 
 ![](https://oscimg.oschina.net/oscnet/up-d24706d1c1447d55adaea3c535ac589353a.png)
 
#### 解决方法：

1. Access Token有效期为一个小时，若超过限定时间，则需要重新获取并使用最新Access Token下发消息。重新获取Access Token方法[可参考文](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/oauth2-0000001212610981?ha_source=hms1)档

2. 确保使用的Access Token与获取的一致，复制Access Token时出现转义字符，需要将“\/”还原为“/”。

### 错误码五：80100016，"消息里面含有敏感信息"

#### 原因分析：

出现这种报错说明推送消息内容中含有敏感信息
 
 ![](https://oscimg.oschina.net/oscnet/up-561d9aa0f089d149ba5fa5218b851167ce1.png)
 
#### 解决方法：

1.	由于不提供敏感词库，需要开发者自行检测内容；

2.	开发者可以接入推必安，下发消息通过推必安审核后，华为不会二次审核。接入推必安的流程可[参考文档]()。

#### 注意事项：

1. 推必安审核通过后，需要将推必安返回通过的结果添加到华为Review字段的result对象中，这样下发消息时华为才能知道消息审核已通过，华为也不会进行二次审核。

```
"review": [
        {
            "reviewer": "tuibian",[]()
            "type": 0,
            "result": {

//以下为推必安返回结果
                "code": 200,
                "data": {
                    "auditEngine": "t****ine",
                    "auditId": "0f74b*******0b3f490d",
                    "labels": []
                },
                "msg": "Pass",
                "sign": "MEQCIBHc********IqLjw=="

}
        }
    ]
}
```

2. 并不是将整个消息体都放到推必安“content”字段中，需要审核的是“message”里面的内容，同时会对消息体内容按ASCII码升序排序后转为字符串格式进行审核。

```
{
    "validate_only":false,
    "message":{

//以下部分需要审核
        "notification":{
            "title":"message title",
            "body":"message body"
        },
        "android":{
            "collapse_key":0,
            "notification":{
                "click_action":{
                    "type":2,
                    "url":"https://example.com"
                }
            }
        },

"token":[
            "pushtoken1"
        ]
    }
} 
```

3. 由于审核过程繁琐，建议减少下发字段的使用，这样操作更简单也会避免下发消息时出现80100018错误码，该错误码指发给三方机构审核的消息体与下发时的消息体不一致。

### 错误码六：sub_error":57303,"error_description":"appid is overload blocked","error":1302

#### 原因分析：

过多请求access_token被流控，流控阈值为1000个/5分钟。

![](https://oscimg.oschina.net/oscnet/up-4f1696cad6559141c2a9c6b01e26f55b52e.png)
 
#### 解决方法：

调整请求逻辑，access_token有效期为一个小时，无需频繁申请。流控5分钟后重置，可以再次申请。更多access_token相关限制可[参考文档](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/oauth2-0000001212610981?ha_source=hms1)。

**了解更多详情>>**

访问[华为开发者联盟官网](http://developer.huawei.com/consumer/cn/hms?ha_source=hms1)  
获取[开发指导文档](http://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)  
华为移动服务开源仓库地址：[GitHub](http://github.com/HMS-Core)、[Gitee](http://gitee.com/hms-core)

**关注我们，第一时间了解 HMS Core 最新技术资讯~**

ITPub博客

【FAQ】接入HMS Core推送服务，服务端下发消息常见错误码原因分析及解决方法

最新文章