BGTaskScheduler已注册任务的launchHandler未执行问题求助

我尝试使用BGTaskScheduler.shared.register(identifier:queue:launchHandler:)调度后台任务，但launchHandler代码块始终未执行。

已尝试的操作 #

• 已在模拟器和真机上测试。
• 已开启后台模式（Background fetch）。
• 已在SceneDelegate的sceneDidEnterBackground(:)方法中通过BGTaskScheduler.shared.submit(:)提交任务。
• 已在Info.plist的"Permitted background task scheduler identifiers"中添加任务标识符。
• 已尝试选择Debug > Simulate Background Fetch。

我的代码 #

func scene(_ scene: UIScene,
           willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {        
    let isRegistered = BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.example.bgTaskIdentifier",
                                                       using: nil) { task in
        print("Executed") // 未打印
        self.handleAppRefresh(task: task as! BGAppRefreshTask)
    }
    
    print("isRegistered: \(isRegistered)") // 打印"isRegistered: true"
}


func sceneDidEnterBackground(_ scene: UIScene) {
    scheduleAppRefresh()
    print("Entered Background") // 打印"Entered Background"
}

func scheduleAppRefresh() {
    let request = BGAppRefreshTaskRequest(identifier: "com.example.bgTaskIdentifier")
    request.earliestBeginDate = Date(timeIntervalSinceNow: 5 * 60)
    
    do {
        try BGTaskScheduler.shared.submit(request)
    } catch {
        print("Could not schedule app refresh: \(error)") // 未进入catch块
    }
}

解决方法 #

1. 调整earliestBeginDate设置 #

你设置了5分钟后才允许任务执行，即便触发Simulate Background Fetch，系统也不会提前执行。测试阶段可以缩短时间或设为nil：

request.earliestBeginDate = Date(timeIntervalSinceNow: 10)
// 或者直接设为nil，允许系统立即调度
// request.earliestBeginDate = nil

2. 必须标记任务完成 #

在handleAppRefresh方法中，一定要调用task.setTaskCompleted(success:)告知系统任务结束，否则系统会判定任务失败，后续可能不再调度：

func handleAppRefresh(task: BGAppRefreshTask) {
    // 执行你的后台逻辑
    print("处理后台刷新任务")
    
    // 标记任务完成
    task.setTaskCompleted(success: true)
}

3. 确认任务是否成功提交 #

提交任务后，通过以下代码检查是否有pending任务，验证提交状态：

func scheduleAppRefresh() {
    let request = BGAppRefreshTaskRequest(identifier: "com.example.bgTaskIdentifier")
    request.earliestBeginDate = Date(timeIntervalSinceNow: 10)
    
    do {
        try BGTaskScheduler.shared.submit(request)
        BGTaskScheduler.shared.getPendingTaskRequests { requests in
            print("待执行任务: \(requests.map { $0.identifier })")
        }
    } catch {
        print("Could not schedule app refresh: \(error)")
    }
}

4. 真机测试的注意事项 #

真机上系统对后台任务调度限制严格：

• 确保设备电量充足、连接稳定Wi-Fi
• App保持后台挂起状态，不要强制关闭
• 避免App在后台长时间无活跃行为

5. 检查权限配置准确性 #

确认Info.plist中的"Permitted background task scheduler identifiers"是数组类型，且任务标识符拼写完全正确，无多余空格或符号。

6. 正确触发后台任务 #

• 触发Debug > Simulate Background Fetch前，必须先让App进入后台（按Home键或Cmd+Shift+H）
• 也可通过终端命令触发模拟器任务：

xcrun simctl spawn booted launchctl submit -l com.example.bgTaskIdentifier -- /usr/bin/open -b com.example.你的AppBundleID

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