Firebase Realtime Database观察者在iOS后台模式下无法工作

你的代码在前台正常但后台无法进入Firebase回调，核心原因是后台任务的生命周期管理错误，以及提前触发了fetchCompletionHandler，导致系统在异步操作完成前就终止了App的后台活动。

关键问题点 #

• 启动后台任务后立刻调用completionHandler(UIBackgroundFetchResult.newData)，系统会判定后台任务已完成，可能直接挂起App，Firebase的异步请求还没来得及执行回调。
• 把更新逻辑放在后台任务的expirationHandler中完全错误，这个回调仅在任务即将超时触发，正常应该在Firebase操作完成后主动结束后台任务。

修复后的代码实现 #

var backgroundTask: UIBackgroundTaskIdentifier = .invalid

func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    
    // 从payload提取pathStr和chatId
    guard let pathStr = userInfo["pathStr"] as? String,
          let chatId = userInfo["chatId"] as? String else {
        completionHandler(.failed)
        return
    }

    // 启动后台任务，设置超时回调
    backgroundTask = UIApplication.shared.beginBackgroundTask { [weak self] in
        UIApplication.shared.endBackgroundTask(self?.backgroundTask ?? .invalid)
        self?.backgroundTask = .invalid
        completionHandler(.failed)
    }

    // 执行送达更新逻辑，完成后收尾后台任务
    markAsDeliverChat(pathStr: pathStr, chatID: chatId) { success in
        UIApplication.shared.endBackgroundTask(self.backgroundTask)
        self.backgroundTask = .invalid
        completionHandler(success ? .newData : .failed)
    }
}

// 修改为带完成回调的异步函数，确保后台任务等待Firebase操作结束
func markAsDeliverChat(pathStr: String, chatID: String, completion: @escaping (Bool) -> Void) {           
    let FIREBASE_CHAT_URL = "https://xxxxxxxxxxxx-default-rtdb.firebaseio.com/"
    let database = Database.database(url: FIREBASE_CHAT_URL).reference()
    let chatRef = database.child("Chat/\(pathStr)")
    let query = chatRef.queryOrdered(byChild: "id").queryEqual(toValue: chatID)
    
    query.observeSingleEvent(of: .value) { snapShot in
        guard let value = snapShot.value as? NSDictionary else {
            print("chat id not found")
            completion(false)
            return
        }
        
        // 在这里执行你的送达状态更新逻辑
        if let messageKey = value.allKeys.first as? String {
            chatRef.child(messageKey).child("delivered").setValue(true) { error, _ in
                completion(error == nil)
            }
        } else {
            completion(false)
        }
    } withCancel: { error in
        print("Firebase query error: \(error.localizedDescription)")
        completion(false)
    }
}

额外注意事项 #

• 确保App已开启Remote notifications后台模式（Xcode中Signing & Capabilities -> Background Modes勾选对应选项）。
• 静默推送的payload必须包含content-available: 1字段，否则系统不会触发后台回调。
• 使用[weak self]避免循环引用，防止内存泄漏。

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