SwiftUI项目中BGTaskScheduler注册后完成处理程序不触发问题

核心排查与修复步骤 #

1. 修正任务注册时机 #

SwiftUI的App结构体init()方法中注册任务不可靠——此时App启动流程未完全完成，BGTaskScheduler的注册上下文可能不完整。改用UIApplicationDelegateAdaptor在App启动完成后注册：

@main
struct YourApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
        do {
            try BGTaskScheduler.shared.register(forTaskWithIdentifier: "com.mycompanyname.fetch", using: nil) { task in
                self.handleAppRefreshTask(task as! BGAppRefreshTask)
            }
        } catch {
            print("后台任务注册失败: \(error)")
        }
        // 首次调度任务
        scheduleAppRefresh()
        return true
    }
    
    private func handleAppRefreshTask(_ task: BGAppRefreshTask) {
        // 设置超时处理
        task.expirationHandler = {
            task.setTaskCompleted(success: false)
        }
        
        // 执行你的业务逻辑
        UserDefaults.standard.set(Date(), forKey: "LastFetchTime")
        
        // 标记任务完成
        task.setTaskCompleted(success: true)
        
        // 重新调度下一次任务
        scheduleAppRefresh()
    }
    
    private func scheduleAppRefresh() {
        let request = BGAppRefreshTaskRequest(identifier: "com.mycompanyname.fetch")
        // 系统会根据资源情况调整触发时间，15分钟是最低间隔要求
        request.earliestBeginDate = Date(timeIntervalSinceNow: 15 * 60)
        
        do {
            try BGTaskScheduler.shared.submit(request)
        } catch {
            print("任务请求提交失败: \(error)")
        }
    }
}

2. 遵守系统后台调度规则 #

• 系统不会严格按照earliestBeginDate触发任务，尤其是App后台闲置时，会优先保障系统资源，触发间隔可能大幅延长。
• 若用户手动划掉App（后台杀死），所有已调度任务会被取消，需用户再次打开App才能重新注册调度。

3. 确保任务持续调度 #

不要只在App启动时提交一次任务，必须在每次任务完成后重新调度（如上述代码中的scheduleAppRefresh()），也可在App从后台回到前台时重新提交，避免任务被系统回收。

4. 验证配置细节 #

• 再次确认Signing & Capabilities中Background Modes已勾选Background fetch。
• 检查Info.plist的BGTaskSchedulerPermittedIdentifiers数组，确保com.mycompanyname.fetch拼写、大小写完全匹配。
• 真机测试时关闭低电量模式，该模式会禁用大部分后台任务。

5. 模拟命令与实际触发的差异 #

Apple提供的模拟命令（xcrun simctl spawn booted bgtasksimulator -submit com.mycompanyname.fetch）是强制触发，不受系统调度限制，仅用于调试；实际场景必须符合系统后台任务调度逻辑。

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