SwiftUI生命周期中如何使用beginBackgroundTask()实现后台任务

你当前实现无法生效的核心原因有两个：

1. UIApplication.willTerminateNotification触发时，系统默认预留的执行窗口不足5秒，你直接发起异步网络请求时，主线程回调执行完系统就会判定应用可终止，直接挂起进程，网络请求根本没机会完成
2. 你没有在发起网络请求前正确申请后台任务断言，且SwiftUI的View是值类型，无法稳定持有后台任务ID，容易出现任务提前被系统回收的问题

具体实现步骤 #

1. 创建独立的后台清理管理器 #

不要把后台任务逻辑直接写在View的闭包中，通过单例管理器稳定持有后台任务ID，统一管理清理逻辑：

import UIKit
import FirebaseFunctions

class AppCleanupManager {
    static let shared = AppCleanupManager()
    private var backgroundTaskID: UIBackgroundTaskIdentifier = .invalid
    
    private init() {}
    
    func removePlayerFromCurrentGame(gameCode: String, playerName: String) {
        // 发起请求前先申请后台任务断言，提前告知系统有未完成任务
        backgroundTaskID = UIApplication.shared.beginBackgroundTask(withName: "GameExitCleanup") { [weak self] in
            // 系统超时回调：必须在此处结束任务，否则会被系统强制终止进程
            guard let self = self else { return }
            UIApplication.shared.endBackgroundTask(self.backgroundTaskID)
            self.backgroundTaskID = .invalid
        }
        
        // 切到全局异步队列执行，避免阻塞主线程
        DispatchQueue.global().async { [weak self] in
            guard let self = self else { return }
            
            Functions.functions().httpsCallable("removeFromGame").call([
                "gameCode": gameCode,
                "playerName": playerName
            ]) { _, error in
                // 无论请求成功/失败/超时，都要结束后台任务断言
                defer {
                    UIApplication.shared.endBackgroundTask(self.backgroundTaskID)
                    self.backgroundTaskID = .invalid
                }
                
                if let error = error {
                    print("对局清理请求失败: \(error.localizedDescription)")
                    return
                }
                print("玩家已成功从对局中移除")
            }
        }
    }
}

2. 修正SwiftUI端的通知监听逻辑 #

不要只依赖willTerminateNotification触发清理——iOS在应用被系统内存回收、用户快速划掉后台等场景下，该通知触发概率不稳定，需要同时监听应用进入后台事件做兜底，监听逻辑放在App入口即可，不需要额外适配AppDelegate：

@main
struct YourGameApp: App {
    // 替换为你自己的全局状态存储，保存当前进行中的对局信息
    @AppStorage("activeGameCode") private var activeGameCode = ""
    @AppStorage("currentPlayerName") private var currentPlayerName = ""
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onReceive(NotificationCenter.default.publisher(for: UIApplication.willTerminateNotification)) { _ in
                    triggerCleanupIfNeeded()
                }
                .onReceive(NotificationCenter.default.publisher(for: UIApplication.didEnterBackgroundNotification)) { _ in
                    // 应用进后台就预执行清理，作为willTerminate未触发的兜底
                    triggerCleanupIfNeeded()
                }
        }
    }
    
    private func triggerCleanupIfNeeded() {
        // 无活跃对局时跳过，避免重复请求
        guard !activeGameCode.isEmpty, !currentPlayerName.isEmpty else { return }
        AppCleanupManager.shared.removePlayerFromCurrentGame(
            gameCode: activeGameCode,
            playerName: currentPlayerName
        )
        // 清理本地对局标记，防止重复调用
        activeGameCode = ""
    }
}

注意事项 #

• 系统给beginBackgroundTask分配的最长执行时间一般在30秒左右，足够完成单次云函数请求，不要在任务中添加任何和清理无关的冗余逻辑
• 不要在View的body中直接初始化Backend类实例，View重绘时会反复生成新实例，导致网络请求生命周期不可控，用单例或全局持有的服务类稳定性更高
• 你原来实现的removeFromGame方法没有在网络回调中执行传入的completion闭包，外层逻辑无法感知任务结束状态，后续复用该方法时需要补全completion调用
• 不要完全依赖客户端请求做清理逻辑：极端场景下（设备断电、网络完全中断）客户端请求无法发出，服务端必须加兜底机制，比如给对局加15-30秒的心跳超时，玩家长时间无心跳上报就自动判定离线移除。

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