Android WorkManager未按指定时间触发问题求助（Xamarin环境）

问题描述 #

尝试通过WorkManager每15分钟执行一次后台任务，通过日志记录DoWork方法确认触发情况，但实际触发时间不符合设定，昨日仅触发一次。使用Xamarin（C#语法），相关代码如下：

MainActivity 中的调度代码 #

PeriodicWorkRequest AdhanScheduleSvc = PeriodicWorkRequest.Builder.From<AdhanScheduleWorker>(TimeSpan.FromMinutes(15)).Build();
//WorkManager.Instance.Enqueue(AdhanScheduleSvc);
WorkManager.GetInstance(Xamarin.Essentials.Platform.AppContext).Enqueue(AdhanScheduleSvc);

DoWork 方法实现 #

public override Result DoWork()
{
    Android.Util.Log.Debug("AdhanWorker", "Worker Started");

    Task.Run(async () =>
    {
        await CreateSchedules();

    }).ContinueWith(t =>
    {
        if (t.IsFaulted)
        {  // Catch Error
            Android.Util.Log.Debug("AdhanWorker", $"I Completed With Error {t.Exception}");
        };
        if (t.IsCompleted)
        {  //optionally do some work);
            Android.Util.Log.Debug("AdhanWorker", "Worker Completed Success");
        }
    });
}

问题原因及解决方案 #

1. DoWork 方法未返回任务结果 #

WorkManager依赖Worker返回的Result确认任务状态，当前代码未返回任何结果，导致WorkManager可能判定任务一直处于运行状态，后续周期性调度被阻塞。

修正方案：

• 改用CoroutineWorker原生支持异步操作（推荐）：

  using AndroidX.Work;
  using Kotlinx.Coroutines;
  
  public class AdhanScheduleWorker : CoroutineWorker
  {
      public AdhanScheduleWorker(Context context, WorkerParameters workerParams) : base(context, workerParams)
      {
      }
  
      public override async Task<Result> DoWorkAsync()
      {
          Android.Util.Log.Debug("AdhanWorker", "Worker Started");
          try
          {
              await CreateSchedules();
              Android.Util.Log.Debug("AdhanWorker", "Worker Completed Success");
              return Result.InvokeSuccess();
          }
          catch (Exception ex)
          {
              Android.Util.Log.Debug("AdhanWorker", $"I Completed With Error {ex}");
              return Result.InvokeFailure();
          }
      }
  }
  

• 若坚持使用Worker，需同步等待异步任务完成后返回结果：

  public override Result DoWork()
  {
      Android.Util.Log.Debug("AdhanWorker", "Worker Started");
      try
      {
          // 同步等待异步任务完成
          Task.Run(async () => await CreateSchedules()).GetAwaiter().GetResult();
          Android.Util.Log.Debug("AdhanWorker", "Worker Completed Success");
          return Result.Success();
      }
      catch (Exception ex)
      {
          Android.Util.Log.Debug("AdhanWorker", $"I Completed With Error {ex}");
          return Result.Failure();
      }
  }
  

2. Android 系统后台限制影响调度 #

从Android 8.0开始，系统对后台任务有严格的电池优化策略，即使设置15分钟间隔，系统也可能因设备休眠、低电量模式等延迟或暂停任务。

优化措施：

• 进入系统设置，关闭应用的电池优化权限；
• Android 12及以上版本，确保申请了POST_NOTIFICATIONS权限（部分场景下后台任务需要前台通知才能稳定运行）；
• 构建PeriodicWorkRequest时添加宽松约束，降低系统限制影响：

  var request = PeriodicWorkRequest.Builder.From<AdhanScheduleWorker>(TimeSpan.FromMinutes(15))
      .SetRequiresBatteryNotLow(false)
      .SetRequiresCharging(false)
      .Build();
  

3. 避免重复入队任务 #

若Enqueue操作在每次Activity启动时都执行，可能导致多个任务实例冲突，影响调度逻辑。

修正方案：
使用EnqueueUniquePeriodicWork确保同一任务只有一个实例在运行：

var uniqueWork = PeriodicWorkRequest.Builder.From<AdhanScheduleWorker>(TimeSpan.FromMinutes(15))
    .Build();
WorkManager.GetInstance(Xamarin.Essentials.Platform.AppContext)
    .EnqueueUniquePeriodicWork("AdhanScheduleTask", ExistingPeriodicWorkPolicy.Keep, uniqueWork);

同时确保调度代码仅执行一次，例如放在MainActivity的OnCreate中并判断savedInstanceState == null：

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    if (savedInstanceState == null)
    {
        // 仅首次启动时调度任务
        var uniqueWork = PeriodicWorkRequest.Builder.From<AdhanScheduleWorker>(TimeSpan.FromMinutes(15)).Build();
        WorkManager.GetInstance(Xamarin.Essentials.Platform.AppContext)
            .EnqueueUniquePeriodicWork("AdhanScheduleTask", ExistingPeriodicWorkPolicy.Keep, uniqueWork);
    }
}

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