Android 13/14定时后台任务调度：WorkManager失效及解决方案咨询

问题分析 #

在Android 13/14设备上，使用WorkManager的PeriodicWorkRequest无法按预期执行每小时定时任务，但低版本系统运行正常。核心原因是Android 12+对后台任务的限制收紧，加上部分厂商的额外后台管控策略。

核心解决方案 #

一、WorkManager 正确配置与适配 #

1. 补充必要权限

在Manifest中添加后台任务相关权限：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- 若任务涉及网络，保留INTERNET权限；涉及位置则添加ACCESS_BACKGROUND_LOCATION -->

• RECEIVE_BOOT_COMPLETED：确保设备重启后任务能重新调度
• FOREGROUND_SERVICE：Android 12+要求长时间运行的后台任务必须启动前台服务

2. 调整PeriodicWorkRequest配置

• 优化调度策略：使用ExistingPeriodicWorkPolicy.KEEP避免每次启动Activity重置任务；添加运行约束确保任务在合适时机执行：

val constraints = Constraints.Builder()
    .setRequiredNetworkType(NetworkType.CONNECTED) // 按需开启，比如任务需网络时
    .setRequiresBatteryNotLow(true) // 避免低电时被系统限制
    .build()

val request = PeriodicWorkRequestBuilder<NotificationWorker>(1, TimeUnit.HOURS)
    .setConstraints(constraints)
    .setInitialDelay(0, TimeUnit.MINUTES) // 立即启动首次任务
    .build()

workManager.enqueueUniquePeriodicWork(
    "reminder_notification_work",
    ExistingPeriodicWorkPolicy.KEEP, // 避免重复更新任务
    request
)

3. Worker适配前台服务（Android 12+）

Android 12+规定后台任务运行超过一定时间必须启动前台服务，修改Worker类：

class NotificationWorker @AssistedInject constructor(
    @Assisted var context: Context,
    @Assisted parameters: WorkerParameters,
) : CoroutineWorker(context, parameters) {

    override suspend fun doWork(): Result {
        return try {
            // Android 12+ 启动前台服务
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
                val foregroundNotification = NotificationCompat.Builder(context, "foreground_channel")
                    .setSmallIcon(R.mipmap.ic_launcher_round)
                    .setContentTitle("后台任务运行中")
                    .setContentText("正在执行定时提醒")
                    .setPriority(NotificationCompat.PRIORITY_LOW)
                    .build()
                setForeground(ForegroundInfo(1001, foregroundNotification))
            }
            NotificationHandler.createNotification(
                context = context,
                title = "Hi from CoroutineWorker",
                content = "CoroutineWorker supports multi-threaded coroutine usage."
            )
            Result.success()
        } catch (e: Exception) {
            Log.d("TAG", "doWork: ${e.message}")
            Result.failure()
        }
    }
}

同时在Manifest注册前台服务类型：

<service
    android:name="androidx.work.impl.foreground.SystemForegroundService"
    android:foregroundServiceType="dataSync" /> <!-- 根据任务类型选择，如dataSync、location等 -->

二、厂商限制处理方案 #

• 引导用户手动开启权限：在App内添加引导页面，提示用户开启以下权限（不同厂商路径不同，可针对性提示）：
  • 小米：设置 → 应用设置 → 应用管理 → 你的App → 省电策略 → 无限制
  • 华为：设置 → 应用和服务 → 应用管理 → 你的App → 电池 → 允许后台活动
  • 三星：设置 → 应用 → 你的App → 电池和内存 → 电池优化 → 不优化
• AlarmManager配合WorkManager：对于需要严格定时的场景，用精确闹钟触发WorkManager任务：
  1. 添加权限：

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

  2. 创建广播接收器：

  class AlarmReceiver : BroadcastReceiver() {
      override fun onReceive(context: Context?, intent: Intent?) {
          context?.let {
              WorkManager.getInstance(it).enqueue(OneTimeWorkRequestBuilder<NotificationWorker>().build())
          }
      }
  }
  

  3. 注册接收器：

  <receiver android:name=".AlarmReceiver" />
  

  4. 设置精确闹钟：

  fun setExactHourlyAlarm(context: Context) {
      val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
      val intent = Intent(context, AlarmReceiver::class.java)
      val pendingIntent = PendingIntent.getBroadcast(
          context,
          0,
          intent,
          PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
      )
      val triggerTime = System.currentTimeMillis() + 60 * 60 * 1000 // 1小时后
  
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
          if (alarmManager.canScheduleExactAlarms()) {
              alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent)
          } else {
              // 引导用户开启精确闹钟权限
              val settingsIntent = Intent(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM)
              settingsIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
              context.startActivity(settingsIntent)
          }
      } else {
          alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent)
      }
  }
  

代码优化建议 #

1. 修复NotificationHandler的通知渠道创建逻辑：渠道名称和描述应固定，而非使用每次通知的内容：

private fun createNotificationChannel(context: Context) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val importance = NotificationManager.IMPORTANCE_HIGH
        val channel = NotificationChannel(CHANNEL_ID, "定时提醒通知", importance).apply {
            description = "接收App定时提醒消息"
        }
        val notificationManager = context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

2. 任务调度逻辑移至Application的onCreate方法，避免在Activity中重复执行。

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