Android 12前台服务后台启动限制：如何用WorkManager修复Beacon SDK报错

问题根因 #

Android 12开始对后台启动前台服务做了严格限制，仅当应用处于前台、或处于系统临时白名单场景时，才允许调用startForeground()，你后台轮询服务端后启动前台服务的场景不符合系统默认授权条件，因此会抛出如下异常：

ForegroundServiceStartNotAllowedException: Service.startForeground() not allowed due to mAllowStartForeground false

WorkManager的**即时任务（Expedited Work）**在Android 12+平台会自动获得系统分配的临时前台服务启动权限，刚好匹配你的场景需求。

核心误区说明：不能直接传递Service实例到Worker #

Worker和Service是Android系统独立管理的组件，生命周期完全分离，不支持跨组件直接传递实例对象。你不需要把Service传给Worker，只需要把原有耦合在Service中的业务逻辑抽离为独立的公共模块，Worker和Service都可以调用公共模块的能力即可。

具体实现步骤 #

1. 业务逻辑解耦 #

把原有Service中的beacon检测、蓝牙定位、业务逻辑处理全部抽离为独立的无状态单例类，比如BeaconMonitorManager，Worker和Service都可以直接调用该类的方法，无需重复写代码。

2. 定义轮询任务Worker #

实现Worker类用来请求服务端开关，判断是否需要启动前台服务，代码示例（Kotlin）：

class CheckForegroundSwitchWorker(private val context: Context, params: WorkerParameters) : CoroutineWorker(context, params) {
    override suspend fun doWork(): Result {
        // 调用服务端接口判断是否需要开启前台服务
        val needStart = requestServerForegroundSwitch()
        if (needStart) {
            // Expedited任务自带临时启动权限，Android 12+也可以正常启动前台服务
            val serviceIntent = Intent(context, YourBeaconForegroundService::class.java)
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                context.startForegroundService(serviceIntent)
            } else {
                context.startService(serviceIntent)
            }
        }
        return Result.success()
    }
}

3. 配置定期任务 #

用WorkManager的周期性任务替换原有后台轮询逻辑，最小支持15分钟的轮询间隔：

// 构建15分钟间隔的周期性即时任务
val periodicWorkRequest = PeriodicWorkRequestBuilder<CheckForegroundSwitchWorker>(15, TimeUnit.MINUTES)
    // 设置为即时任务，获得系统临时启动前台服务的权限
    .setExpedited(OutOfQuotaPolicy.RUN_AS_NON_EXPEDITED_WORK_REQUEST)
    .build()
// 提交任务，避免重复提交
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
    "check_beacon_foreground_switch",
    ExistingPeriodicWorkPolicy.KEEP,
    periodicWorkRequest
)

4. 原有前台服务适配 #

原有Service无需大幅修改，仅需要在Manifest中补充Android 12+要求的前台服务类型声明即可：

<service
    android:name=".YourBeaconForegroundService"
    android:foregroundServiceType="location|connectedDevice"
    android:exported="false" />

服务启动后正常调用startForeground()挂载通知即可，继续使用之前抽离的BeaconMonitorManager处理业务逻辑。

注意事项 #

• 需提前向用户申请定位权限、蓝牙权限、Android 13+的通知权限，否则前台服务无法正常运行
• 如果需要小于15分钟的轮询间隔，可以用一次性任务配合完成后自调度实现，不建议间隔小于5分钟，容易被系统后台查杀
• WorkManager的任务在用户未强行停止应用的前提下，即使应用被手动杀死也会被系统自动调度，符合你杀应用后继续运行的需求

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