API31+应用关闭时无法通过BroadcastReceiver启动前台服务弹窗

问题场景 #

通过ACTION_BOOT_COMPLETED广播触发启动WindowLeadsService（用于显示悬浮弹窗的前台服务）时，触发以下异常：

java.lang.RuntimeException: android.app.ForegroundServiceStartNotAllowedException: startForegroundService() not allowed due to mAllowStartForeground false: service

即使在Service的onCreate方法中调用了startForeground()，问题依然存在。

错误原因 #

Android 12（API 31）及以上版本新增了后台启动限制：应用未处于前台状态时，禁止调用startForegroundService()。开机完成后，应用尚未被用户主动唤醒，处于后台状态，直接调用startForegroundService()会触发该异常。

解决方案 #

1. 使用WorkManager调度服务启动 #

WorkManager是Android官方推荐的后台任务调度组件，可在系统允许的时机执行任务，规避后台启动限制。

2. 确保服务正确配置前台类型 #

Android 12+要求前台服务声明foregroundServiceType，明确服务用途。

3. 确认悬浮窗权限已授权 #

悬浮窗需要SYSTEM_ALERT_WINDOW权限，该权限需用户手动在系统设置中开启。

代码修改示例 #

修改BroadcastReceiver，改用WorkManager调度 #

public class RebootService extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction())) {
            // 创建延迟执行的任务，等待系统稳定后再启动服务
            OneTimeWorkRequest workRequest = new OneTimeWorkRequest.Builder(StartServiceWorker.class)
                    .setInitialDelay(10, TimeUnit.SECONDS)
                    .build();
            WorkManager.getInstance(context).enqueue(workRequest);
        }
    }
}

创建Worker类负责启动服务 #

public class StartServiceWorker extends Worker {
    public StartServiceWorker(@NonNull Context context, @NonNull WorkerParameters workerParams) {
        super(context, workerParams);
    }

    @NonNull
    @Override
    public Result doWork() {
        Context context = getApplicationContext();
        Intent serviceIntent = new Intent(context, WindowLeadsService.class);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            try {
                context.startForegroundService(serviceIntent);
            } catch (ForegroundServiceStartNotAllowedException e) {
                Log.e("StartServiceWorker", "后台无法启动前台服务，将重试", e);
                return Result.retry(); // 重试或根据需求返回Result.failure()
            }
        } else {
            context.startService(serviceIntent);
        }
        return Result.success();
    }
}

调整WindowLeadsService的前台启动逻辑 #

确保startForeground()在onStartCommand中调用，覆盖服务重启的场景：

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // 每次启动服务都确保前台状态
    startForegroundService();
    return START_NOT_STICKY;
}

@Override
public void onCreate() {
    super.onCreate();
    createNotificationChannel();
    // 初始化悬浮窗逻辑保持不变
    windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
    LayoutInflater inflater = (LayoutInflater) getSystemService(LAYOUT_INFLATER_SERVICE);
    dialogView = inflater.inflate(R.layout.customized_leads, null);
    // ... 剩余悬浮窗初始化及点击事件逻辑
}

清单文件配置更新 #

1. 注册Worker（AndroidManifest.xml中添加）：

<provider
    android:name="androidx.work.impl.WorkManagerInitializer"
    android:authorities="${applicationId}.workmanager-init"
    android:exported="false"
    tools:node="remove" />

<service
    android:name="androidx.work.impl.foreground.SystemForegroundService"
    android:foregroundServiceType="dataSync" />

2. 配置Service的前台类型：

<service android:name=".WindowLeadsService"
         android:foregroundServiceType="systemAlertWindow" />

3. 确认权限声明：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

内容的提问来源于stack exchange，提问作者devz.xpert