集成了GoEasy原生插件实现Uniapp通知栏推送收不到通知，如何排查？

无论您是使用IM即时通讯 还是websocket消息推送需要通知栏推送收不到通知栏推送都可以通过以下方式来排查。本地通知跟离线通知的区别通知栏推送分两种理解了这个对接下来如何排查很重要本地通知离线通知本地通知指app在后台运行且goeasy websocket连接未断开时处理的通知栏推送此时通知栏推送是goeasy sdk完成的无上架要求。离线通知 指goeasy连接断开或者app进程被杀后需要通过厂商推送来实现的通知栏提醒。什么意思呢 就是这种情况下只有通过各个手机厂商自己的推送服务平台向手机推送通知栏推送。目前goeasy支持以下厂商APNs iOS苹果小米 需要上架才能推送华为vivo 需要上架才能推送oppo魅族FCM (这个只适用海外用户通过google服务来进行通知栏推送国内的项目用不上因为google服务被墙了)如何排查收不到本地通知初始化时allowNotification值是否为true发送消息时是否有带notification的相关参数在手机系统设置里确认该app的通知栏提醒为“允许”状态GoEasy的sdk版本是否低于2.2.8如果是请在官网下载最新的sdk进行集成检查manifest.json中权限配置是否勾选NOTIFICATION相关权限并检查manifest.json的源码视图中是否有同步更新检查manifest.json中模块配置是否勾选上了push模块, 且一定不能勾选unipush检查manifest.json的源码视图中distribute节点中配置中是否包含pushRegisterMode参数配置pushRegisterMode是unipush的配置个别hbuilder版本下模块配置中没有勾选unipush但是源码视图中有。如果有需要删除这个参数。GoEasy连接是否已经断开 如果已经断开则需要集成厂商通道才能推送通知栏提醒注意大多数vivo手机一切换到后台运行后app的某些资源几乎会马上回收导致goeasy连接断开所以需要结合goeasy后台的在线客户端页面来确认连接是否还在如果是付费应用排查是否购买了通知栏推送服务如何排查收不到离线通知APNs (iOS苹果离线推送)不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipush确认iOS推送证书是否配置正确90%的用户都是这一块有问题重点排查a. 请确认是否在GoEasy后台上传时的iOS的推送证书【跟制作基座时用的证书是完全不同的证书打包时用的是开发证书厂商推送是推送证书】b. ios推送证书与开发证书的bundle id是否一致c. 推送证书是否是测试环境跟正式环境通用的证书d. 如果您选择的运行证书的环境为正式环境您的app是否已经上架app storee. 如果app已经上架需要选择正式环境如果选择了测试环境则收不到确认iOS开发证书是否包含push notification权限如果没有需要重新生成开发证书如果还是不工作强烈建议按照文档重新生成一次推送证书小米离线推送不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipush小米开放平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致小米推送服务没有通过申请。app需要在小米应用市场上架并在小米开发平台申请推送服务只有申请通过后才能使用小米离线推送。在GoEasy网后台配置uniapp通知栏推送小米参数时提示无效导致没有成功配置小米厂商解决方案小米如果是刚开启的推送权限需要等待几分钟后才会生效。您可以等3分钟以后再去配置打自定义基座时报错“arguments invalid”在原生插件配置页面没有正确配置厂商相关参数解决方案检查配置值的前后是否有多余的空格 其次检查值是否正确比如appkey 跟appsecret的值要正确不要填错了受到小米厂商推送限制影响。如果至少收到过一次离线推送说明厂商配置没有问题可能受到小米厂商限制需要申请小米厂商分类消息。 参考文档https://docs.goeasy.io/2.x/common/notification/channel_category华为离线推送不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipush华为开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致华为开发者平台中的推送服务是否成功的开启是否正确的生成了SHA256证书指纹打自定义基座时报错“arguments invalid”在原生插件配置页面没有正确配置厂商相关参数解决方案检查配置值的前后是否有多余的空格 其次检查值是否正确goeasy后台厂商通道配置参数要正确受到华为厂商推送限制的影响。如果至少收到过一次离线推送说明厂商配置没有问题可能受到华为厂商限制需要申请华为厂商分类消息。 参考文档https://docs.goeasy.io/2.x/common/notification/channel_categoryvivo离线推送不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看 注意大多数vivo手机一切换到后台运行后app的某些资源几乎会马上回收导致goeasy连接断开所以需要结合goeasy后台的在线客户端页面来确认连接是否还在是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipushvivo开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致vivo开发者平台中的推送服务是否已经通过申请app是否在vivo应用市场已上架打自定义基座时报错“arguments invalid”在原生插件配置页面没有正确配置厂商相关参数解决方案检查配置值的前后是否有多余的空格 其次检查值是否正确goeasy后台厂商通道配置参数要正确受到vivo厂商推送限制的影响。如果至少收到过一次离线推送说明厂商配置没有问题可能受到vivo厂商限制需要发送时需要根据业务真实指定classification参数 0运营类消息1系统类消息不填默认为1。 参考文档https://docs.goeasy.io/2.x/common/notification/channel_categoryoppo离线推送不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipushoppo开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致oppo开发者平台中的推送服务是否已经通过申请打自定义基座时报错“arguments invalid”在原生插件配置页面没有正确配置厂商相关参数解决方案检查配置值的前后是否有多余的空格 其次检查值是否正确appkeyappsecret appserversecret 的值要正确的填写goeasy后台厂商通道配置参数要正确受到oppo厂商推送限制的影响。如果至少收到过一次离线推送说明厂商配置没有问题可能受到oppo厂商限制需要申请oppo厂商分类消息。 参考文档https://docs.goeasy.io/2.x/common/notification/channel_category魅族离线推送不工作app在后台运行是否可以收到通知栏提醒如果收不到说明代码或者环境有问题需要先解决这个问题再往下看是否添加了原生插件并按文档要求打包自定义基座特别是是须勾选了push模块且不能勾选unipush魅族开发者平台填写的应用包名是否与制作自定义基座时填写的Android包名完全一致魅族开发者平台中的推送服务是否已经开启打自定义基座时报错“arguments invalid”在原生插件配置页面没有正确配置厂商相关参数解决方案检查配置值的前后是否有多余的空格 其次检查值是否正确appkeyappsecret 的值要正确的填写goeasy后台厂商通道配置参数要正确FCM 没有使用到所以没有相关问题排查。如果以上排除步骤无法锁定原因按照GoEasy厂商通道配置文档再走两遍不要自认为没有问题厂商通道的配置没有什么难点主要是要细心。如果实在无法排查到原因就上GoEasy官网找客服吧他们会很耐心地帮您排查问题。通知栏消息提醒方式问题1: 为啥我的通知栏消息没有悬浮弹窗提醒答通知栏消息被静默显示一方面取决于厂商对不同类型通知有不同的展示规则另一个方面也要取决于app在手机上的设置看是否打开了悬浮通知。问题2: 为啥小米手机上不是每条消息都会通知比如发送3条只有第一条会有提示后面两条都没有提示答这个取决于手机操作系统的规则为了在避免打扰到用户部分手机厂商会对通知频繁的app进行提示限制比如只会折叠通知不会响铃有些手机厂商只有当用户点击了通知之后才会重新提醒带提示音。监听通知栏点击事件户点击通知栏消息除了APP被自动拉起外开发者还可以通过监听通知栏消息的点击事件根据消息数据执行相应的业务逻辑比如跳转到不同的页面或显示不同的内容。为了避免在APP启动后因为监听动作未完成而导致APP无法响应点击操作确保APP总是可以第一时间响应通知栏消息的点击事件请务必在main.js GoEasy初始化后立即监听onClickNotification事件。