1. 通过API发送消息时候报错:cannot find user by this audience or has been inactive for more than 255 days

(1)出现这个问题有两种原因,一种是要发送的用户不存在;另一种是该用户255天之内没有登录过,被我们服务器清理掉了。

(2)如果是alias/tag进行推送,很有可能是alias/tag没有设置成功,一个alias最多免费给10台设备进行使用,开通VIP权限可以没有限制,自己可以检查一下或者换一个alias进行设置。Tag报错一般不会是这个数量问题,如果出错那就是么有设置成功,根据文档以及demo自己检查一下,如果是registration_id进行推送,有可能regid不对,进行检查一下。

(3)另一种就是该用户长时间未登录,被我们清理掉了,那么就不存在该用户,推送时候去掉此用户即可,用户重新下载app即可。

2. 在集成成功的情况下,收不到推送怎么办

 1.Android端可以通过以下进行排查:
    1.1 通知权限是否开启,有些手机通知权限下面还会区分普通,不重要,重要消息等级,这个也需要查看一下,比如vivo手机;还有手机会有消息盒子,会将消息放在消息盒子里面,比如魅族手机
    1.2. 如果通过tag,regid,alias对设备进行推送没有收到通知,很有可能是tag或者alias没有设置成功以及regid出现错误。一个alias至多免费设置给10台设备,可以调用API查询一下是否设置tag或者alias成功: http://docs.jiguang.cn/jpush/server/push/rest_api_v3_device/
    1.3 是否调用了stoppush,若是请调 resumepush 进行恢复
    1.4 更加详细的排查,可以查看此文章:https://community.jiguang.cn/article/51921

2.IOS端可以通过以下进行排查:
    2.1 首先也是通知权限是否开启
    2.2 第二点也是tag,alias是否设置成功
    2.3 环境是否匹配,IOS区分开发环境以及生产环境,对应的app也是区分的,具体可以查看此文档:https://community.jiguang.cn/article/57171 
    2.4 更加详细的排查,可以查看此文章:https://community.jiguang.cn/article/51501

3. 设备别名报6002,6027等错误

1)  最近很多反馈设备别名报6002等错误,这是因为一个别名最多免费给10台设备进行使用,如果超过了会报错。检查是否是这个的原因可以换一个别名试试;
(2) 另一种情况就是,已经设置了别名A,再次设置别名还是设置A,也会出现这个错误;关于别名是否绑定了哪些设备,相关查询的文档http://docs.jiguang.cn/jpush/client/Android/android_api/#api_3 3)删除别名绑定的所有设备,可以调用API进行删除:http://docs.jiguang.cn/jpush/server/push/rest_api_v3_device/#_5

4. 使用API进行推送的时候,如果报 ‘parameter invalid’,可能以下几种情况

(1) 缺少必填的参数,文档中必填的参数一定都需要带上

(2) 格式不正确,带上了参数,但是参数的格式没有按照要求来

(3) 目标不存在,比如你通过registration进行推送,但是这个registration是不存在或者你随便写的,那么推送的时候也是会报错的;同理如果alias进行推送,没有一个用户也是此报错。

5. 极光后台推送,报错:请检查参数合法性

进行推送的时候预估人数为0会报此错误:

(1)如果是广播推送预估人数为0,则没有任何用户安装此app,至少的有一个用户安装;如果有用户安装了,但是后台没有显示,检查是否安装成功,获取设备的registration id

(2)如果是alias,tag等推送预估人数为0,那么alias或者tag没有设置成功,无任何设备绑定此alias或者tag,请重新设置并且加回调查看,或者打开log日志进行查看;也可以通过API查询此alias或者tag下面是否有设备:http://docs.jiguang.cn/jpush/server/push/rest_api_v3_device/#_2 

6. 如果IOS编译失败,报错误:Could not find or use auto-linked framework 'AppTrackingTransparency'

 升级XCode版本到12可以解决问题

7. IOS上架被拒,原因是会出现获取local network的提示

升级Push 到最新的SDKJCore至少2.3.6版本即以上

8.海外客户没有手机号如何注册

将页面切换成英文,港澳以及海外地区不会要求验证手机

9. google play 上架被拒,怎么办

我们有专门的google play版本的SDK,您可以查看此文章进行详解,[点击](https://community.jiguang.cn/article/372890)
Mainfest配置里面涉及到的位置信息属于可选项,如果您不需要用到,则可以去掉。Manifest里面写了required为必选项,不能去掉。

10.华为角标无法清零问题

关于此问题,您可以查看此篇文章,[点击](https://community.jiguang.cn/article/465005)

11.APP进程被杀死收不到推送

如果您没有集成厂商通道,这个是属于正常现象,因为极光通道是基于长链接的,进程被杀死,长连接断开,则收不到推送

您可以通过集成厂商通道实现进程被杀死的情况下也收到推送,官方集成指南: [http://docs.jiguang.cn/jpush/client/Android/huawei-Push-guide/](http://docs.jiguang.cn/jpush/client/Android/huawei-Push-guide/) 

完整的集成步骤,您可以查看此链接:[https://community.jiguang.cn/article/464984](https://community.jiguang.cn/article/464984) 

如果第一次集成厂商通道,建议您优先使用demo进行查看。

12. 厂商通道集成步骤以及常见问题,点击

13. 集成厂商通道成功,下发消息时是走极光通道还是厂商通道呢

1.同时集成厂商通道以及极光通道,下发的时候有一个 下发策略 需要填写,极光web控制台如图中所示,不做修改默认会厂商通道有些,无效时走极光通道

null

2.如果是调用API进行发送,也有对应的参数需要填写,官网文档说明:http://docs.jiguang.cn/jpush/server/push/rest_api_v3_push/#options

null

14. 连接不上服务器,出现如图报错信息,“read response from JPush Server timed out
null

1.首先检查您的网络是否受到了限制,如果您的网络是受到限制的,您可以查看此文章将需要的域名加进去:https://community.jiguang.cn/article/120091
2.如果您的网络没有受到限制,您可以ping一下服务器的域名,比如JPush的ping api.jpush.cn,查看是否可以ping通;如果ping不通,并且换了网络也是ping失败,那么请您将ping的结果进行发送提问,并且详细描述自己的问题
3.如果是可以ping通的,那么很大问题是您的服务器有问题,您可以看一下使用postman或者curl命令发送的消息能否发送成功并且收到,如果可以,那您需要检查您自己的服务器或者客户端的网络,检查一下自己配置的环境。

15. 推送选择使用大图片样式时候,推送的URL是否支持待认证的链接

目前还不支持类似阿里的oss 带认证的就不会显示图片了,比如链接格式(http://xxxx-demo.oss-cn-hangzhou.aliyuncs.com/panda.png?x-oss-process=image/format,jpg),暂时只支持以jpg或者png结尾的链接图片

16. 极光是否支持类似美团那样的语音消息推送功能

1、没有办法直接推送语音消息的,在消息里面带上语音的下载链接,客户端收到后处理。 
2、如果只是自定义声音提醒:  
Android 自定义声音 [点我](https://community.jiguang.cn/article/133751)  
iOS 自定义声音 [点我](https://community.jiguang.cn/article/99921)

17. JPush推送相关问题,涉及到推送成功但是没有收到推送的,提写明regid以及mesgid,方便查看。关于收不到推送的原因之前也有相关文章,可以根
据文章先自己进行排查(「JPush」收不到消息的排查方案-极光社区 (jiguang.cn))。

18. 之前的常见问题汇总文章,点击精华

备注:极光社区有很多类似的问题以及文章,出现问题,您可以自己先社区进行搜索答案,官方也会不定期更新常见问题,您可以关注官方账户。