SwiftUI中如何执行后台任务？已配置但任务未触发

问题说明 #

在SwiftUI App中尝试使用后台刷新任务（appRefresh）获取随机图片并推送通知，提交任务后未触发执行，预期任务能正常运行。

核心问题排查与解决步骤 #

1. 补充必须的Info.plist配置 #

后台任务需要在Info.plist中声明权限和允许的标识符，这是最容易遗漏的环节：

• 添加BGTaskSchedulerPermittedIdentifiers数组，将任务标识符randomImage加入其中
• 添加UIBackgroundModes数组，包含fetch（对应后台刷新权限）

Info.plist源码视图配置示例：

<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
    <string>randomImage</string>
</array>
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
</array>

2. 注册后台任务处理逻辑 #

使用BGTaskScheduler提交任务前，必须先注册任务处理逻辑。修改WeatherAppApp代码如下：

@main
struct WeatherAppApp: App {
    @StateObject private var imageStore = ImageStore()
    
    init() {
        // 注册后台刷新任务
        do {
            try BGTaskScheduler.shared.register(forTaskWithIdentifier: "randomImage", using: nil) { task in
                Task {
                    await self.refreshAppData()
                    task.setTaskCompleted(success: true)
                }
            }
        } catch {
            print("注册后台任务失败: \(error.localizedDescription)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView(imageStore: imageStore)
        }
    }
    
    func refreshAppData() async {
        print("\(type(of: self)) \(#function) triggered")
        
        let content = UNMutableNotificationContent()
        content.title = "一张随机图片已准备好！"
        content.subtitle = "快来查看！"
        
        if await fetchRandomImage() {
            try? await UNUserNotificationCenter.current().add(UNNotificationRequest(identifier: "test", content: content, trigger: UNTimeIntervalNotificationTrigger(timeInterval: 1, repeats: false)))
        }
    }
    
    func fetchRandomImage() async -> Bool {
        guard let url = URL(string: "https://picsum.photos/200/300"),
              let (data, response) = try? await URLSession.shared.data(from: url),
              let response = response as? HTTPURLResponse, response.statusCode == 200 else {
            return false
        }
        
        imageStore.randomImage = UIImage(data: data)
        return true
    }
}

3. 任务处理的关键注意事项 #

• 任务处理完成后必须调用task.setTaskCompleted(success:)，否则系统会判定任务失败，后续可能降低任务触发频率
• earliestBeginDate设置的时间不宜过短（测试场景可设为当前时间后2秒，真实场景建议至少15分钟）

4. 正确测试后台任务 #

iOS后台任务受系统调度限制，需按以下方式测试：

1. 在Xcode中运行App，点击「请求通知权限」完成授权，再点击「调度后台任务」
2. 将App切换到后台（模拟器按Command+Shift+H，真机按Home键）
3. 在Xcode顶部菜单选择Debug > Simulate Background Refresh，选择任务标识符randomImage
4. 查看控制台输出，确认refreshAppData方法被触发，同时会收到推送通知

修正后的ContentView代码 #

import SwiftUI
import BackgroundTasks

class ImageStore: ObservableObject {
    @Published var randomImage: UIImage?
}

extension ImageStore {
    static let shared = ImageStore()
}

struct ContentView: View {
    @ObservedObject var imageStore: ImageStore
    
    var body: some View {
        VStack {
            Button("请求通知权限") {
                UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound]) { success, error in
                    if success {
                        print("通知权限已授权")
                    } else if let error = error {
                        print("授权失败: \(error.localizedDescription)")
                    }
                }
            }
            .buttonStyle(.borderedProminent)
            .padding()
            
            Button("调度后台任务") {
                let request = BGAppRefreshTaskRequest(identifier: "randomImage")
                request.earliestBeginDate = Calendar.current.date(byAdding: .second, value: 2, to: Date())
                do {
                    try BGTaskScheduler.shared.submit(request)
                    print("后台任务已调度")
                } catch {
                    print("调度失败: \(error.localizedDescription)")
                }
            }
            .buttonStyle(.bordered)
            .tint(.red)
            .padding()
            
            // 显示获取到的随机图片
            if let image = imageStore.randomImage {
                Image(uiImage: image)
                    .resizable()
                    .scaledToFit()
                    .frame(width: 200, height: 300)
            }
        }
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView(imageStore: ImageStore.shared)
    }
}

内容的提问来源于stack exchange，提问作者Jason Rich Darmawan