在SwiftUI应用中如何使用FirebaseFirestore监听实时更新

前置配置 #

• 项目已完成Firebase基础接入，引入FirebaseFirestore、FirebaseFirestoreSwift依赖，如需关联用户身份还需引入FirebaseAuth
• 提前定义和Firestore文档结构匹配的数据模型，遵守Codable协议简化解析逻辑，示例如下：

struct TodoItem: Codable, Identifiable {
    // 自动映射Firestore文档ID
    @DocumentID var id: String?
    var title: String
    var isCompleted: Bool
    var createTime: Timestamp
}

方案1：基于ObservableObject封装监听管理类（最常用） #

适合需要跨页面共享监听数据、监听逻辑复杂的场景，通过SwiftUI的状态管理机制自动驱动界面更新。

实现步骤 #

1. 定义继承自ObservableObject的ViewModel，存储监听实例和同步后的数据

import Foundation
import FirebaseFirestore

class TodoViewModel: ObservableObject {
    // 暴露给视图的响应式数据
    @Published var todoList: [TodoItem] = []
    // 存储监听实例，用于后续销毁
    private var listener: ListenerRegistration?
    private let db = Firestore.firestore()
    
    /// 开启指定集合的实时监听
    func startListen(userId: String) {
        // 先销毁旧监听避免重复注册
        stopListen()
        
        listener = db.collection("users").document(userId).collection("todos")
            .order(by: "createTime", descending: true)
            .addSnapshotListener { [weak self] snapshot, error in
                guard let self = self, let snapshot = snapshot, error == nil else {
                    print("监听异常: \(error?.localizedDescription ?? "未知错误")")
                    return
                }
                // 批量解析文档到模型
                self.todoList = snapshot.documents.compactMap { doc in
                    try? doc.data(as: TodoItem.self)
                }
            }
    }
    
    /// 销毁监听，避免内存泄漏和配额浪费
    func stopListen() {
        listener?.remove()
        listener = nil
    }
}

2. 在SwiftUI视图中绑定ViewModel，根据页面生命周期启停监听

import SwiftUI
import FirebaseAuth

struct TodoListView: View {
    // 页面生命周期内持有ViewModel
    @StateObject private var viewModel = TodoViewModel()
    // 示例：获取当前登录用户ID
    private let currentUserId = Auth.auth().currentUser?.uid ?? ""
    
    var body: some View {
        List(viewModel.todoList) { item in
            HStack {
                Text(item.title)
                Spacer()
                Image(systemName: item.isCompleted ? "checkmark.circle.fill" : "circle")
                    .foregroundColor(item.isCompleted ? .green : .gray)
            }
        }
        .onAppear {
            viewModel.startListen(userId: currentUserId)
        }
        .onDisappear {
            viewModel.stopListen()
        }
    }
}

方案2：轻量单个文档监听（无需ViewModel） #

适合仅需要监听单个文档、不需要跨页面共享数据的场景，利用SwiftUI的task修饰符自动管理生命周期。

struct TodoDetailView: View {
    let todoId: String
    let userId: String
    @State private var todoItem: TodoItem?
    private let db = Firestore.firestore()
    
    var body: some View {
        VStack(spacing: 16) {
            if let item = todoItem {
                Text(item.title)
                    .font(.title)
                Text("创建时间：\(item.createTime.dateValue().formatted())")
                Text("完成状态：\(item.isCompleted ? "已完成" : "未完成")")
            } else {
                ProgressView("加载中...")
            }
        }
        .padding()
        .task {
            // 注册文档监听
            let listener = db.collection("users").document(userId)
                .collection("todos").document(todoId)
                .addSnapshotListener { snapshot, error in
                    guard let doc = snapshot, error == nil else { return }
                    todoItem = try? doc.data(as: TodoItem.self)
                }
            // 页面消失task取消时自动销毁监听
            await withTaskCancellationHandler {
                // 持有点监听直到任务取消
                for await _ in AsyncStream<Void> { _ in }
            } onCancel: {
                listener.remove()
            }
        }
    }
}

核心注意事项 #

• 必须及时销毁不需要的监听，否则会导致内存泄漏、持续消耗流量，还会占用Firebase的请求配额产生额外成本
• 如果需要监听元数据变更（比如本地缓存修改同步状态），可以在调用addSnapshotListener前添加.includeMetadataChanges()参数
• 针对数据量较大的集合，建议配合分页逻辑做分段监听，避免一次性加载过多数据导致界面卡顿
• 数据解析优先使用FirebaseFirestoreSwift提供的data(as:)方法，避免手动解析字典的冗余代码和出错概率

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