Android 10及以上版本接收推送时自动打开React Native App失败

问题根源 #

Android 10（API 29）开始引入后台启动Activity限制，系统禁止后台组件（比如广播接收器）直接调用startActivity()拉起App，这就是你现有代码在高版本失效的核心原因——低版本无此限制，所以能正常运行。

解决方案 #

方案1：通过通知引导用户打开（推荐，符合系统规范） #

高版本系统鼓励通过通知让用户主动触发App启动，这是最稳妥的方式。修改广播接收器代码，构建推送通知并绑定打开App的PendingIntent：

public void onReceive(Context context, Intent intent) {
    Log.d(TAG, "broadcast received for message");

    Intent launchIntent = context.getPackageManager().getLaunchIntentForPackage("com.theDocSuiteDriver");
    if (launchIntent != null) {
        // 设置启动Flags，确保App正常启动
        launchIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);

        // 创建PendingIntent，高版本需指定FLAG_IMMUTABLE
        PendingIntent pendingIntent = PendingIntent.getActivity(
                context,
                0,
                launchIntent,
                PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
        );

        // 构建通知（需提前创建通知渠道，Android 8.0+要求）
        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, "YOUR_NOTIFICATION_CHANNEL_ID")
                .setSmallIcon(R.drawable.ic_notification) // 替换为你的通知图标
                .setContentTitle("新推送通知")
                .setContentText("点击打开App查看详情")
                .setPriority(NotificationCompat.PRIORITY_DEFAULT)
                .setContentIntent(pendingIntent)
                .setAutoCancel(true);

        // 显示通知
        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
        notificationManager.notify(1, builder.build());
    }
}

注意：Android 8.0及以上必须先创建通知渠道，否则通知无法显示。可以在App启动时添加渠道创建代码：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel channel = new NotificationChannel(
            "YOUR_NOTIFICATION_CHANNEL_ID",
            "推送通知渠道",
            NotificationManager.IMPORTANCE_DEFAULT
    );
    NotificationManager notificationManager = context.getSystemService(NotificationManager.class);
    if (notificationManager != null) {
        notificationManager.createNotificationChannel(channel);
    }
}

方案2：后台直接拉起（仅特定场景允许） #

如果你的App满足系统允许后台启动的条件（比如用户最近10分钟内打开过App、App正在运行前台服务等），可以修改Intent Flags并适配高版本限制：

public void onReceive(Context context, Intent intent) {
    Log.d(TAG, "broadcast received for message");

    Intent launchIntent = context.getPackageManager().getLaunchIntentForPackage("com.theDocSuiteDriver");
    if (launchIntent != null) {
        // 替换原有Flag，添加必要的启动标记
        launchIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK 
                | Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
                | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);

        // Android 10+ 检查是否允许后台启动
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
            // 检查App是否在最近任务列表中
            if (activityManager != null && !activityManager.getAppTasks().isEmpty()) {
                context.startActivity(launchIntent);
            } else {
                // 不满足后台启动条件， fallback到显示通知
                // 这里可以调用方案1中的通知构建代码
            }
        } else {
            // 低版本直接启动
            context.startActivity(launchIntent);
        }
    }
}

关键说明 #

• 系统限制后台启动Activity是为了减少不必要的App打扰，提升用户体验，因此优先选择方案1。
• Android 12及以上，PendingIntent必须指定FLAG_IMMUTABLE或FLAG_MUTABLE，大多数场景用FLAG_IMMUTABLE即可。

内容的提问来源于stack exchange，提问作者sanjay solanki