Android：迁移Foreground Service至WorkManager实现持续前台通知

针对你遇到的ForegroundServiceStartNotAllowedException，以及WorkManager通知无法持续的问题，核心是让WorkManager的Worker保持前台状态并维持任务生命周期，具体方案如下：

1. 使用支持挂起的Worker并启用前台模式 #

WorkManager的CoroutineWorker（或ListenableWorker）支持前台模式，通过setForeground()方法可让Worker以前台身份运行，通知会持续显示直到Worker主动结束或被系统取消。

2. 实现持续运行的位置监听逻辑 #

不能让doWork()方法立即返回，需在方法内启动位置监听，并用挂起逻辑保持Worker活跃，直到需要停止。

代码示例 #

class LocationTrackingWorker(
    context: Context,
    params: WorkerParameters
) : CoroutineWorker(context, params) {

    private lateinit var locationCallback: LocationCallback
    private val fusedLocationClient by lazy { LocationServices.getFusedLocationProviderClient(context) }

    override suspend fun doWork(): Result {
        // 1. 创建通知渠道（Android 8.0+ 必填）
        createNotificationChannel()

        // 2. 构建前台通知
        val notification = NotificationCompat.Builder(applicationContext, "LOCATION_TRACKING_CHANNEL")
            .setContentTitle("位置追踪中")
            .setContentText("正在后台获取位置信息")
            .setSmallIcon(R.drawable.ic_location)
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build()

        // 3. 设置Worker为前台模式，通知会持续显示
        setForeground(ForegroundInfo(1001, notification))

        // 4. 初始化位置回调
        locationCallback = object : LocationCallback() {
            override fun onLocationResult(locationResult: LocationResult) {
                super.onLocationResult(locationResult)
                // 处理获取到的位置信息
                val location = locationResult.lastLocation
                location?.let {
                    // 此处编写位置处理逻辑，如上传服务器等
                }
            }
        }

        // 5. 请求位置更新
        return try {
            val locationRequest = LocationRequest.create().apply {
                interval = 10000 // 10秒更新一次，可按需调整
                fastestInterval = 5000
                priority = LocationRequest.PRIORITY_HIGH_ACCURACY
            }

            fusedLocationClient.requestLocationUpdates(
                locationRequest,
                locationCallback,
                Looper.getMainLooper()
            )

            // 6. 保持Worker活跃，直到被取消
            awaitCancellation()
            Result.success()
        } catch (e: Exception) {
            Result.failure()
        } finally {
            // 7. 取消位置监听，释放资源
            fusedLocationClient.removeLocationUpdates(locationCallback)
        }
    }

    private fun createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                "LOCATION_TRACKING_CHANNEL",
                "位置追踪",
                NotificationManager.IMPORTANCE_LOW
            ).apply {
                description = "后台位置追踪通知"
            }
            val notificationManager = applicationContext.getSystemService(NotificationManager::class.java)
            notificationManager.createNotificationChannel(channel)
        }
    }
}

3. 启动Worker #

val workRequest = PeriodicWorkRequestBuilder<LocationTrackingWorker>(15, TimeUnit.MINUTES)
    .setConstraints(Constraints.Builder()
        .setRequiredNetworkType(NetworkType.CONNECTED) // 按需设置运行约束
        .setRequiresBatteryNotLow(true)
        .build())
    .build()

WorkManager.getInstance(context).enqueueUniquePeriodicWork(
    "LOCATION_TRACKING_WORK",
    ExistingPeriodicWorkPolicy.KEEP,
    workRequest
)

关键注意点 #

• 权限申请：确保已申请ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATION权限，Android 13+还需申请POST_NOTIFICATIONS权限。
• 功耗优化：合理设置位置更新间隔，优先使用低功耗精度模式（如PRIORITY_BALANCED_POWER_ACCURACY）。
• 取消逻辑：当用户停止追踪时，调用WorkManager.getInstance(context).cancelUniqueWork("LOCATION_TRACKING_WORK")，Worker会触发awaitCancellation()，进而执行finally块释放资源。

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