Android 11中WebSocketServer子类调用startActivity首次有效后续失效问题

1. Android 11后台启动Activity限制：从Android 10开始，系统就限制后台应用直接启动Activity，Android 11进一步收紧了该规则。当你的应用处于后台（无可见界面、无前台服务）时，直接调用startActivity会被系统拦截，仅少数临时场景（如刚进入后台的短时间窗口）允许启动。首次请求可能刚好处于系统允许的临时窗口内，后续请求时应用已完全进入后台，被系统阻止。
2. Intent Flags组合不合理：当前使用的FLAG_ACTIVITY_CLEAR_TASK | FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_CLEAR_TOP，在目标Activity已存在于任务栈时，会触发onNewIntent而非重新创建Activity，但由于应用处于后台，系统不会主动将该Activity带到前台，导致你误以为启动失败。

1. 启用前台服务（核心解决后台启动限制） #

要在后台合法启动Activity，必须让应用拥有前台服务权限，步骤如下：

• 在AndroidManifest.xml中声明权限：

  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <!-- Android 12+需额外声明服务类型，示例： -->
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" />
  

• 创建前台服务类，必须显示持久通知：

  public class WsForegroundService extends Service {
      private static final int NOTIFICATION_ID = 1001;
  
      @Override
      public int onStartCommand(Intent intent, int flags, int startId) {
          // Android 8.0+需创建通知渠道
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
              NotificationChannel channel = new NotificationChannel("ws_channel", "WebSocket服务", NotificationManager.IMPORTANCE_LOW);
              NotificationManager manager = getSystemService(NotificationManager.class);
              manager.createNotificationChannel(channel);
          }
  
          Notification notification = new NotificationCompat.Builder(this, "ws_channel")
                  .setContentTitle("WebSocket服务运行中")
                  .setContentText("等待客户端请求")
                  .setSmallIcon(R.drawable.ic_notification)
                  .build();
  
          startForeground(NOTIFICATION_ID, notification);
          return START_STICKY;
      }
  
      @Nullable
      @Override
      public IBinder onBind(Intent intent) {
          return null;
      }
  }
  

• 在应用启动时（如MyApplication的onCreate）启动该服务：

  Intent serviceIntent = new Intent(this, WsForegroundService.class);
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
      startForegroundService(serviceIntent);
  } else {
      startService(serviceIntent);
  }
  

2. 调整Intent Flags，确保Activity能被带到前台 #

替换原Flags组合，确保即使Activity已存在，也能被调至前台：

Intent intent = new Intent(MyApplication.getInstance().context, ThirdPartyActivity.class);
intent.putExtra("TransType", 1);
intent.putExtra("Amount", String.valueOf(12000));
intent.putExtra("ResNum", "1111111111111111111111111");
intent.putExtra("AppId", "1");
intent.putExtra("Timer",60_000);

// 新Flags组合：创建新任务（若需要），并将Activity移至栈顶
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);

MyApplication.getInstance().context.startActivity(intent);

3. （可选）手动检查并调起已存在的Activity #

如果不想修改Flags，可在启动前检查目标Activity是否已在任务栈中，若存在则直接将任务调至前台：

ActivityManager activityManager = (ActivityManager) MyApplication.getInstance().context.getSystemService(Context.ACTIVITY_SERVICE);
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.R) {
    List<ActivityManager.RunningTaskInfo> taskInfos = activityManager.getRunningTasks(10);
    for (ActivityManager.RunningTaskInfo taskInfo : taskInfos) {
        if (taskInfo.topActivity.getClassName().equals(ThirdPartyActivity.class.getName())) {
            activityManager.moveTaskToFront(taskInfo.id, 0);
            conn.send("Text to client");
            return;
        }
    }
}

// 任务不存在时正常启动
Intent intent = new Intent(MyApplication.getInstance().context, ThirdPartyActivity.class);
// 填充额外参数...
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
MyApplication.getInstance().context.startActivity(intent);

注：getRunningTasks在Android 11及以上已废弃，仅适用于低版本兼容，高版本需使用其他方式检测Activity状态。

内容的提问来源于stack exchange，提问作者behnam karimi