Android前台服务运行时，移除最近应用后无法启动应用

问题场景 #

已实现带通知的前台服务，当前台服务运行、通知可见时，将应用从最近应用列表移除，随后点击应用图标启动，出现短暂黑屏且应用无法启动，必须通过应用设置强制关闭后才能恢复。

核心代码参考 #

前台服务实现 #

public class FileSyncService extends Service {

    private static final int FILE_SYNC_SERVICE_ID = 901;
    public static final String FILE_SYNC_SERVICE_ACTION_STOP = "StopFileSyncService";
    public static final String FILE_SYNC_SERVICE_ACTION_START = "StartFileSyncService";

    @Inject
    private FilePushManager filePushManager;

    @Inject
    private NotificationController notificationController;

    @Override
    public void onCreate() {
        super.onCreate();
        Logger.d("[FileSyncService][onCreate]");
        BootstrappingManager.getInstance().getInjector().injectMembers(this);
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Logger.d("[FileSyncService][onStartCommand]");

        if (intent != null && intent.getAction() != null && intent.getAction().equals(FILE_SYNC_SERVICE_ACTION_STOP)) {
            Logger.d("[FileSyncService][onStartCommand] stopSelf");
            stopForegroundService();

        } else {
            Logger.d("[FileSyncService][onStartCommand] startForeground");
            startForeground(FILE_SYNC_SERVICE_ID, notificationController.createFileSyncNotification());
            filePushManager.startFilePush();
        }
        return START_STICKY;
    }

    @Override
    public void onDestroy() {
        Logger.d("[FileSyncService] onDestroy");
        super.onDestroy();
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }

    private void stopForegroundService() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            stopForeground(STOP_FOREGROUND_REMOVE);
        } else {
            stopForeground(true);
        }
        stopSelf();
    }
}

服务启动/停止工具类 #

public static void startFileSyncService(Context context) {
    Intent serviceIntent = new Intent(context, FileSyncService.class);
    serviceIntent.setAction(FileSyncService.FILE_SYNC_SERVICE_ACTION_START);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        Logger.d("[MandatoryUtils][startFileSyncService] foreground");
        try {
            context.startForegroundService(serviceIntent);
        } catch (SecurityException e) {
            Logger.e("[MandatoryUtils][startFileSyncService] unable to start File Sync Service", e);
        } catch (Exception e) {
            Logger.e("[MandatoryUtils][startFileSyncService] unable to start File Sync Service Exception", e);
        }
    } else {
        Logger.d("[MandatoryUtils][startFileSyncService] ");
        context.startService(serviceIntent);
    }
}

public static void stopFileSyncService(Context context) {
    Logger.d("[MandatoryUtils][stopFileSyncService]");
    Intent serviceIntent = new Intent(context, FileSyncService.class);
    serviceIntent.setAction(FileSyncService.FILE_SYNC_SERVICE_ACTION_STOP);
    context.startService(serviceIntent);
}

启动页Manifest配置 #

<application
    android:name="net.activities.MainApplication"
    android:allowBackup="false"
    android:icon="@drawable/scl"
    android:label="@string/app_name"
    android:manageSpaceActivity="net.activities.SplashActivity"
    android:networkSecurityConfig="@xml/network_security_config"
    android:resizeableActivity="false"
    android:theme="@style/ContentLibraryTheme"
    tools:replace="allowBackup, android:theme">
    <uses-library android:name="org.apache.http.legacy" android:required="false" />

    <activity
            android:name="net.activities.SplashActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:exported="true"
            android:theme="@style/Theme.App.Splash"
            android:windowSoftInputMode="adjustResize">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />

            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
<!-- 其他组件配置 -->
</application>

可能原因分析 #

1. 进程状态冲突：当应用从最近列表移除时，系统可能终止应用主进程，但前台服务因android:stopWithTask="false"配置仍在运行，导致启动应用时，系统重建主进程过程中与服务所在进程状态冲突，引发启动阻塞。
2. START_STICKY副作用：服务返回START_STICKY会在进程被杀死后自动重启，但重启时依赖的注入组件（如BootstrappingManager）未正确初始化，导致服务卡住，进而阻塞应用启动流程。
3. 启动页阻塞逻辑：SplashActivity若存在同步等待服务状态的代码，会导致启动流程停滞，出现黑屏。

解决方案 #

1. 调整服务重启策略 #

将onStartCommand返回值从START_STICKY改为START_NOT_STICKY或START_REDELIVER_INTENT，避免不必要的自动重启：

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // 原有逻辑保持不变
    return START_NOT_STICKY; // 无需自动重启时使用，若需恢复任务则用START_REDELIVER_INTENT
}

2. 规范服务Manifest配置 #

根据业务需求设置stopWithTask属性，避免进程状态冲突：

<service
    android:name=".FileSyncService"
    android:stopWithTask="true"> <!-- 默认值，任务移除时自动停止服务 -->
    <!-- 若需服务持续运行，设置为false，但需额外处理进程同步逻辑 -->
</service>

3. 确保服务初始化安全 #

优化服务onCreate中的注入逻辑，避免因初始化失败导致服务卡住：

@Override
public void onCreate() {
    super.onCreate();
    Logger.d("[FileSyncService][onCreate]");
    BootstrappingManager manager = BootstrappingManager.getInstance();
    if (manager.getInjector() != null) {
        manager.getInjector().injectMembers(this);
    } else {
        Logger.e("[FileSyncService][onCreate] Injector未初始化，停止服务");
        stopSelf();
        return;
    }
    // 后续初始化逻辑
}

4. 优化应用后台事件处理 #

若业务允许，在应用进入后台时主动停止前台服务，避免进程冲突：

// 在Application类中添加生命周期监听
public class MainApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        ProcessLifecycleOwner.get().getLifecycle().addObserver(new DefaultLifecycleObserver() {
            @Override
            public void onStop(@NonNull LifecycleOwner owner) {
                // 应用进入后台，停止前台服务
                MandatoryUtils.stopFileSyncService(getApplicationContext());
            }
        });
    }
}

注：需添加依赖implementation "androidx.lifecycle:lifecycle-process:2.6.2"

5. 修复启动页阻塞逻辑 #

移除SplashActivity中同步等待服务的代码，改用异步监听方式：

// SplashActivity中示例
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_splash);
    
    // 通过LiveData或回调监听服务状态
    FilePushManager pushManager = ...; // 获取实例
    pushManager.getRunningState().observe(this, isRunning -> {
        if (isRunning) {
            startActivity(new Intent(this, MainActivity.class));
            finish();
        } else {
            // 服务未运行，直接进入主页面或提示
            startActivity(new Intent(this, MainActivity.class));
            finish();
        }
    });
}

内容的提问来源于stack exchange，提问作者Rachita Nanda