Android 14中BOOT_COMPLETED启动前台服务触发SecurityException问题

核心原因 #

Android 14（API 34）对后台启动前台服务（FGS）新增了严格限制：当应用处于未被用户交互的后台状态（比如设备刚开机时通过BOOT_COMPLETED广播触发），即使持有必要权限，也无法直接启动类型为location的前台服务，除非应用符合系统豁免条件（如用户主动交互、绑定服务等）。

关键结论 #

FOREGROUND_SERVICE_LOCATION是安装时权限，无需运行时请求，你的问题不在这个权限上。

解决方案 #

1. 改用WorkManager启动前台服务

WorkManager在BOOT_COMPLETED场景下属于系统豁免的启动源，可以合法启动前台服务：

• 清单中配置WorkManager初始化（Android 12+推荐）：

<provider
    android:name="androidx.startup.InitializationProvider"
    android:authorities="${applicationId}.androidx-startup"
    android:exported="false"
    tools:node="merge">
    <meta-data
        android:name="androidx.work.WorkManagerInitializer"
        android:value="androidx.startup" />
</provider>

• 创建Worker类处理服务启动：

class BootWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    override fun doWork(): Result {
        val intent = Intent(applicationContext, MainService::class.java)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            applicationContext.startForegroundService(intent)
        } else {
            applicationContext.startService(intent)
        }
        return Result.success()
    }
}

• 在BOOT_COMPLETED广播接收器中调度任务：

class BootReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == Intent.ACTION_BOOT_COMPLETED) {
            val workRequest = OneTimeWorkRequestBuilder<BootWorker>().build()
            WorkManager.getInstance(context!!).enqueue(workRequest)
        }
    }
}

2. 引导用户主动触发服务启动

如果必须保留广播接收器逻辑，可以在BOOT_COMPLETED触发时发送通知，引导用户点击后再启动前台服务——用户交互后应用进入前台状态，即可合法启动location类型服务：

class BootReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == Intent.ACTION_BOOT_COMPLETED) {
            val pendingIntent = PendingIntent.getService(
                context,
                0,
                Intent(context, MainService::class.java),
                PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
            )
            val notification = NotificationCompat.Builder(context!!, "BOOT_CHANNEL")
                .setContentTitle("需要启动定位服务")
                .setContentText("点击启动")
                .setSmallIcon(R.drawable.ic_notification)
                .setContentIntent(pendingIntent)
                .build()
            
            val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                val channel = NotificationChannel("BOOT_CHANNEL", "启动通知", NotificationManager.IMPORTANCE_DEFAULT)
                notificationManager.createNotificationChannel(channel)
            }
            notificationManager.notify(2, notification)
        }
    }
}

3. 额外检查项

• 确认清单已添加RECEIVE_BOOT_COMPLETED权限：

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

• 启动服务前再次校验ACCESS_FINE_LOCATION权限（部分设备重启后可能出现权限状态异常）：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
    // 权限未授予时的处理逻辑（如跳转权限申请页）
    return
}

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