iOS端Firestore在App断开时数据删除失败问题求助

真机上sceneDidDisconnect中的Firestore删除操作异常，核心原因是：

• 该回调触发时，系统留给App的后台运行时间极短，且你当前的多个delete调用均为异步执行，未等待完成就返回；
• 真机系统对后台进程的限制远严于模拟器，导致部分或全部删除操作来不及完成就被系统挂起。

方案1：批量写入+后台任务（客户端直接处理） #

将多个删除操作合并为一个批量请求，同时申请后台任务延长执行时间，确保操作在进程被挂起前完成。

import Firebase
import FirebaseFirestore
import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    
    let db = Firestore.firestore()
    var window: UIWindow?
    var backgroundTask: UIBackgroundTaskIdentifier = .invalid

    func sceneDidDisconnect(_ scene: UIScene) {
        // 申请后台执行时间
        backgroundTask = UIApplication.shared.beginBackgroundTask(withName: "CleanupFirestoreData") { [weak self] in
            self?.endBackgroundTask()
        }

        // 创建批量写入对象
        let batch = db.batch()
        
        // 批量添加所有删除操作
        let doc1Ref = db.collection("parentCol").document("doc").collection("col_1").document("doc_1")
        let doc2Ref = db.collection("parentCol").document("doc").collection("col_2").document("doc_2")
        let parentDocRef = db.collection("parentCol").document("doc")
        
        batch.deleteDocument(doc1Ref)
        batch.deleteDocument(doc2Ref)
        batch.deleteDocument(parentDocRef)

        // 提交批量任务并处理结果
        batch.commit { [weak self] error in
            if let error = error {
                print("批量删除失败: \(error.localizedDescription)")
            } else {
                print("所有数据删除成功")
            }
            self?.endBackgroundTask()
        }
    }
    
    private func endBackgroundTask() {
        if backgroundTask != .invalid {
            UIApplication.shared.endBackgroundTask(backgroundTask)
            backgroundTask = .invalid
        }
    }
}

方案2：云函数处理（更可靠） #

若客户端后台时间仍不足以完成操作，推荐使用Firebase云函数在服务器端执行删除逻辑，不受客户端进程限制。

云函数代码（Node.js） #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.cleanupRoomData = functions.https.onCall(async (data, context) => {
    const roomId = data.roomId;
    if (!roomId) {
        throw new functions.https.HttpsError("invalid-argument", "必须提供roomId");
    }

    const db = admin.firestore();
    const roomRef = db.collection("rooms").doc(roomId);
    
    // 批量删除子集合文档
    const membersSnapshot = await roomRef.collection("members").get();
    const batch = db.batch();
    membersSnapshot.docs.forEach(doc => batch.delete(doc.ref));
    // 删除房间主文档
    batch.delete(roomRef);
    
    await batch.commit();
    return { success: true };
});

客户端调用代码 #

func sceneDidDisconnect(_ scene: UIScene) {
    backgroundTask = UIApplication.shared.beginBackgroundTask(withName: "TriggerCleanupFunction") { [weak self] in
        self?.endBackgroundTask()
    }

    let functions = Functions.functions()
    functions.httpsCallable("cleanupRoomData").call(["roomId": "你的roomId"]) { result, error in
        if let error = error as NSError? {
            if error.domain == FunctionsErrorDomain {
                let code = FunctionsErrorCode(rawValue: error.code)
                print("云函数调用失败: \(code?.rawValue ?? 0), \(error.localizedDescription)")
            }
        }
        self.endBackgroundTask()
    }
}

private func endBackgroundTask() {
    if backgroundTask != .invalid {
        UIApplication.shared.endBackgroundTask(backgroundTask)
        backgroundTask = .invalid
    }
}

• 权限校验：确认Firestore规则允许当前用户删除目标文档，比如设置规则让认证用户只能删除自己创建的房间数据；
• 删除顺序：Firestore删除父文档不会自动删除子集合，必须先删除子集合文档，再删除父文档；
• 真机测试：测试时不要直接杀死App，按Home键让App进入后台，等待系统触发sceneDidDisconnect，或用Xcode Debug菜单模拟后台场景。

内容的提问来源于stack exchange，提问作者Hkr-Y