全部产品
云市场
云游戏
    Android推送失败排查步骤

Android推送失败排查步骤

更新时间:2020-08-11 10:23:13

概述

本文主要介绍Android端推送失败的排查步骤及解决方法。

详细信息

阿里云提醒您:

  • 如果您对实例或数据有修改、变更等风险操作,务必注意实例的容灾、容错能力,确保数据安全。
  • 如果您对实例(包括但不限于ECS、RDS)等进行配置与数据修改,建议提前创建快照或开启RDS日志备份等功能。
  • 如果您在阿里云平台授权或者提交过登录账号、密码等安全信息,建议您及时修改。

首次接入推送不成功

首次接入推送不成功时,您可以参考以下步骤,定位并解决问题:

  • 检查推送通道是否初始化成功,确保您在初始化时,注册的onSuccess回调函数能被成功调用。
  • 如果推送通道初始化失败:请查看错误日志以及错误码,按照错误提示,检查appKey、appSecret等相关配置。
  • 如果发送的是消息,则不会在客户端通知栏弹出展示,需要客户端实现消息回调,自定义消息的展示方式。
  • 使用官方Demo进行测试,排除自身配置问题。使用官方Demo时,需要设置您自己的appKey、appSecret并修改包名。如果使用官方Demo测试无问题,请确认下自己的实现和Demo的区别。
  • 如果您的设备集成了阿里云移动推送Android SDK,设备上日志显示初始化成功,控制台显示设备在线,但是出现推送失败问题,请检查参数是否符合规范。
    您APP的versionName参数和versionName参数不能为null,同时长度不能超过32位。如果versionName参数不符合要求,请更改versionName参数。
    说明:修改后务必先卸载原有App然后重新安装,不要直接覆盖安装。
  • 如果集成成功,请向设备推送通知,发现通知显示已到达,但设备端并未弹窗显示。请确认推送的是通知还是消息,只有通知才会在通知栏创建通知,消息不会创建通知,需要用户在SDK端的onMessage接口中自行处理。如果自定义接收器没有收到数据,请检查自定义接收器是否注册。
  • 推送消息,设备端日志显示已经收到推送,但用户回调未被调用。推送消息在客户端上的路由过程涉及到发送应用内广播,部分设备存在广播拦截,请确认您的设备是否存在该问题:
    1. 下图是正常情况下的日志,第一条handleRemoteMessage日志说明消息已经到达客户端,第二条AgooMessageReceiver日志表明用户自定义receiver已经接收到广播。
      正常日志
    2. 如果只有第一条日志,未出现第二条日志,则说明receiver没有正常接收到广播,需要测试设备是否会拦截广播。测试代码如下,利用该代码给您的自定义receiver发送广播,测试receiver是否可以收到对应广播,如果收不到则说明存在广播拦截情况。
      Intent intent = new Intent();
      intent.setAction("org.agoo.android.intent.action.RECEIVE");
      intent.setPackage(pack);//pack为应用包名。
      intent.putExtra("type", "common-push");
      intent.addFlags(32);
      context.sendBroadcast(intent);//请使用ApplicationContext进行测试。
    3. 如果存在拦截情况,请确认你的设备是否不允许监听系统广播。在manifest.xml文件中将自定义receiver所监听的系统广播注释掉,具体操作如下代码所示。
      <!-- 消息接收监听器 (用户可自主扩展) -->
            <receiver
                android:name=".demo.MyMessageReceiver"
                android:exported="true">
                <intent-filter>
                    <action android:name="com.alibaba.push2.action.NOTIFICATION_OPENED" />
                </intent-filter>
                <intent-filter>
                    <action android:name="com.alibaba.push2.action.NOTIFICATION_REMOVED" />
                </intent-filter>
                <intent-filter>
                    <action android:name="com.taobao.accs.intent.action.COMMAND" />
                </intent-filter>
                <intent-filter>
                    <action android:name="com.taobao.taobao.intent.action.COMMAND" />
                </intent-filter>
                <intent-filter>
                    <action android:name="org.agoo.android.intent.action.RECEIVE" />
                </intent-filter>
                <!--<intent-filter>-->
                    <!--<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />-->
                <!--</intent-filter>-->
                <!--<intent-filter>-->
                    <!--<action android:name="android.intent.action.USER_PRESENT" />-->
                <!--</intent-filter>-->
                <!--<intent-filter>-->
                    <!--<action android:name="android.intent.action.BOOT_COMPLETED" />-->
                <!--</intent-filter>-->
                <!--<intent-filter>-->
                    <!--<action android:name="android.intent.action.PACKAGE_REMOVED" />-->
                    <!--<data android:scheme="package" />-->
                <!--</intent-filter>-->
            </receiver>
      重复步骤2的操作,观察是否可以成功接收广播。如果可以,则说明您的设备不允许监听系统广播。注意当前receiver不监听系统广播不影响功能的正常使用,但会影响SDK的保活能力。
  • 设备绑定标签后,服务端按该标签推送,15分钟后才能生效送达,请参见Android标签API
  • 若您是Android 8以上系统,请参见Android 8.0以上设备接收不到推送通知

成功接入后出现异常

  • 推送通知,如果有设备能收到,有设备不能收到,请检查不能收到通知的手机设置情况,是否将推送App的通知弹出进行了限制。
  • 如果出现应用处于前台可以收到推送,应用在后台后无法接收到推送的情况。请检查channel进程是否执行了推送初始化操作。
    • 判断channel是否执行初始化方法:
      查看channel进程是否有如下日志输出,如果没有,则表示未执行相应初始化操作。
      12-26 11:26:19.673 1951-1951/com.alibaba.push2:channel I/SecurityBoxService: Aliyun
      12-26 11:26:19.677 1951-1951/com.alibaba.push2:channel I/MPS:CloudPushService: [AMS]Initialize Mobile Push service...
      12-26 11:26:19.727 1951-1951/com.alibaba.push2:channel D/MPS:CloudPushService: load utdid: Vs6CkGxR86QDANku3NiLD/yA
      12-26 11:26:19.743 1951-1951/com.alibaba.push2:channel D/MPS:AppRegister: getLooper called.
      12-26 11:26:19.744 1951-1989/com.alibaba.push2:channel D/MPS:AppRegister: Looping Prepared.
      12-26 11:26:19.744 1951-1989/com.alibaba.push2:channel D/MPS:AppRegister: Looping handleMessage: 1
      12-26 11:26:19.747 1951-1989/com.alibaba.push2:channel D/MPS:AppRegister: accs init.
      12-26 11:26:19.747 1951-1989/com.alibaba.push2:channel D/MPS:AppRegister: initAccsChannel...
      12-26 11:26:19.748 1951-1989/com.alibaba.push2:channel I/MPS:AppRegister: [AMS]appkey:23552881
    • 常见错误:
      • 用户在自定义Application中,执行推送SDK初始化时进行了进程判断,导致初始化操作只在主进程执行。错误代码如下所示:
        public class MyApplication extends Application {
           @override
           public void onCreate() {
               super.onCreate();
               if(XXX) {
                   initCloudChannel(this);
               }
           }
           ......
        }
      • 用户在activity中进行相关初始化操作,但是activity只会在主进程创建,导致相关操作只能在主进程执行。错误代码如下所示:
        public class MyActivity extends Activity {
           @override
           public void onCreate(Bundle savedInstanceState) {
               super.onCreate(savedInstanceState);
               initCloudChannel(getApplicationContext());
               ......
           }
           ......
        }
  • 部分ROM对应用自动拉起管控较严格,如果您的设备是小米或者华为,且当前应用已结束,建议配置小米和华为辅助通道以及小米托管弹窗,可以提升到达率。相关信息请参见小米和华为系统推送支持
  • 利用推送排查系统排错:
    获取设备deviceID,对deviceID单独推送一条,登录移动研发平台EMAS,单击移动推送,选择对应的项目,然后单击排查工具即可。
  • 如果推送排查页面显示未知错误,请确认测试设备是否关闭了推送通道,即是否调用过turnOffPushChannel接口。如果是,必须再次调用turnOnPushChannel接口重新打开推送通道。
  • 使用测试环境appKey测试正常,切换成正式环境appKey(测试和正式环境appKey对应相同的包名)之后收不到推送。SDK在初始化过程中有本地请求缓存,更换appKey后需清理本地缓存或卸载测试环境App重新安装正式环境App。
  • 从V2.+版本升级到V3.+版本后接收不到推送。
    由于V2.+和V3.+版本在配置上有所区别,详细排查逻辑请参见移动推送Android SDK从2.+版本升级到3.+版本后收不到通知/消息

问题仍未解决

  • 您可以加入钉钉群咨询问题:
  • 或者提交工单,提交工单时请选择移动推送类目。

反馈问题时,请附带下述格式化的上下文信息,方便阿里云技术支持快速定位问题(带*项必填):

您的操作行为:
异常的现象:
设备的平台(Android还是iOS)、机型、系统版本号:
推送类型(消息还是通知):
推送方式(all、account、device、tag、alias):
* appkey:
* 消息ID(控制台可以查看):
* deviceID(终端日志可以查看):

适用于

  • 移动推送