Android 15中BOOT_COMPLETED接收器启动前台服务失败的解决方案咨询

Android 15 对后台上下文启动前台服务的限制进一步收紧，BOOT_COMPLETED 广播接收器属于后台上下文，直接调用 startForegroundService() 会触发 ForegroundServiceStartNotAllowedException——该场景不在系统允许的豁免范围内。以下是合规的解决思路和代码示例：

方案一：使用 WorkManager 调度前台任务（推荐） #

WorkManager 是 Android Jetpack 提供的后台任务调度组件，完全适配 Android 15 的后台规范，适合处理开机后需要启动的长期/周期性任务。

步骤1：添加 WorkManager 依赖 #

在模块级 build.gradle（或 build.gradle.kts）中添加依赖：

dependencies {
    implementation "androidx.work:work-runtime:2.8.1"
}

步骤2：创建 Worker 类 #

Worker 是 WorkManager 的任务执行单元，在这里我们可以启动前台服务，或者直接在 Worker 内部执行任务并绑定前台通知：

class NetworkSpeedWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    companion object {
        private const val NOTIFICATION_ID = 1001
        private const val CHANNEL_ID = "network_speed_channel"
    }

    override fun doWork(): Result {
        // 方案A：启动独立的前台服务（兼容原有逻辑）
        val serviceIntent = Intent(applicationContext, NetworkSpeedService::class.java)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            applicationContext.startForegroundService(serviceIntent)
        } else {
            applicationContext.startService(serviceIntent)
        }

        // 方案B：直接在Worker中执行任务并设置前台通知（更简洁，无需单独Service）
        // val foregroundNotification = createForegroundNotification()
        // setForegroundAsync(ForegroundInfo(NOTIFICATION_ID, foregroundNotification))
        // 执行你的网络测速/数据同步逻辑...

        return Result.success()
    }

    private fun createForegroundNotification(): Notification {
        // 创建通知渠道（Android 8.0+ 必需）
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                "网络测速服务",
                NotificationManager.IMPORTANCE_LOW
            )
            val notificationManager = applicationContext.getSystemService(NotificationManager::class.java)
            notificationManager.createNotificationChannel(channel)
        }

        return NotificationCompat.Builder(applicationContext, CHANNEL_ID)
            .setContentTitle("网络测速服务")
            .setContentText("正在监控网络速度")
            .setSmallIcon(R.drawable.ic_notification)
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build()
    }
}

步骤3：修改 BootReceiver 调度任务 #

在广播接收器中不再直接启动服务，而是调度 WorkManager 任务：

class BootReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (Intent.ACTION_BOOT_COMPLETED == intent.action) {
            // 创建一次性任务请求，可添加延迟避免开机初期资源竞争
            val workRequest = OneTimeWorkRequestBuilder<NetworkSpeedWorker>()
                .setInitialDelay(10, TimeUnit.SECONDS)
                .build()
            // 提交任务
            WorkManager.getInstance(context).enqueue(workRequest)
        }
    }
}

方案二：临时豁免（仅特殊场景） #

如果必须在广播接收器中直接启动前台服务，Android 15 允许通过 PendingIntent 触发的前台服务启动（需用户后续交互），但该方式不适用于开机启动场景（无用户交互触发），因此不推荐。

关键注意事项 #

1. 保留原有权限配置：FOREGROUND_SERVICE_DATA_SYNC 和 RECEIVE_BOOT_COMPLETED 权限仍需在 AndroidManifest.xml 中声明
2. 前台服务必须在启动后 5秒内 调用 startForeground()，否则会触发 ANR 或崩溃
3. 若使用方案B（Worker内直接执行任务），可删除独立的 NetworkSpeedService 组件，简化架构

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