UWP后台任务仅运行一次问题排查求助

你的后台任务仅触发一次的核心原因是SystemTrigger的OneShot参数设置为true，该参数控制触发器是否仅执行一次。设为true时，即便后续再次满足联网条件，触发器也不会再激活后台任务。此外，还有几处配置和代码细节需要调整，确保任务能独立运行并多次触发。

1. 修正触发器的OneShot参数 #

注册后台任务时，将SystemTrigger的第二个参数从true改为false，这样每次网络连接状态变为可用时，都会触发任务：

// 修改注册代码中的触发器部分
RegisterBackgroundTask("AppService.testNoteUpdaterTask", "testNoteUpdaterX", new SystemTrigger(SystemTriggerType.InternetAvailable, false));

2. 确保Package.appxmanifest正确声明后台任务 #

必须在应用清单中注册后台任务，否则系统不会调度任务。打开Package.appxmanifest：

• 切换到功能选项卡，勾选后台任务；
• 切换到应用程序清单选项卡，添加以下扩展：

<Extensions>
  <Extension Category="windows.backgroundTasks" EntryPoint="AppService.testNoteUpdaterTask">
    <BackgroundTasks>
      <Task Type="systemEvent" />
    </BackgroundTasks>
  </Extension>
</Extensions>

注意EntryPoint要与后台任务类的完全限定名一致。

3. 请求后台任务权限 #

Windows 10及以后版本，后台任务需要用户授权。在注册任务前先调用权限请求：

public async Task RegisterBackgroundTaskWithPermission()
{
    var status = await BackgroundExecutionManager.RequestAccessAsync();
    if (status == BackgroundAccessStatus.AllowedMayUseActiveRealTimeConnectivity || 
        status == BackgroundAccessStatus.AllowedWithAlwaysOnRealTimeConnectivity)
    {
        RegisterBackgroundTask("AppService.testNoteUpdaterTask", "testNoteUpdaterX", new SystemTrigger(SystemTriggerType.InternetAvailable, false));
    }
}

// 在MainPage构造函数中调用（构造函数无法直接async，用异步初始化）
public MainPage()
{
    this.InitializeComponent();
    _ = RegisterBackgroundTaskWithPermission();
}

4. 修正后台任务中的异步操作 #

ToastContentBuilder.Show()是异步方法，直接调用会导致任务在Toast显示前就终止。改用ShowAsync()并等待完成：

public async void Run(IBackgroundTaskInstance taskInstance)
{
    _deferral = taskInstance.GetDeferral(); 

    await new ToastContentBuilder()
        .AddArgument("action", "testNote")
        .AddArgument("conversationId", 9813)
        .AddText("Program update available for testNote")
        .AddButton(new ToastButton()
            .SetContent("testNote stuff")
            .AddArgument("action", "open")
            .SetBackgroundActivation())
        .ShowAsync(); 
    
    _deferral.Complete();
}

5. 保留重复注册检查逻辑 #

你的注册代码已经包含同名任务检查逻辑，这部分是正确的，无需修改，只需确保在权限请求通过后再执行注册。

完成以上调整后，后台任务会在每次网络连接可用时触发，且独立于主应用运行。

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