如何将@FirestoreQuery从View迁移至外部类实现查询复用？

错误原因 #

@FirestoreQuery是SwiftUI View专属的属性包装器，它依赖View的生命周期管理来维持实例唯一性和监听有效性。直接在ObservableObject类中使用它会脱离View的生命周期上下文，导致每次访问都创建新实例，触发你遇到的错误。

正确实现方案 #

方案一：用Firestore原生API结合ObservableObject管理查询

这种方式完全脱离@FirestoreQuery，手动实现实时监听并通过@Published发布结果，适合多View复用查询逻辑的场景。

1. 定义CarsProvider类：

import FirebaseFirestore
import FirebaseFirestoreSwift
import Combine

class CarsProvider: ObservableObject {
    @Published var cars: [Car] = []
    @Published var loadError: Error?
    private var listener: ListenerRegistration?
    private let targetUserId: String
    
    // 初始化时传入当前用户UID
    init(userId: String) {
        self.targetUserId = userId
        startRealTimeListening()
    }
    
    // 销毁时移除监听，避免内存泄漏
    deinit {
        stopListening()
    }
    
    private func startRealTimeListening() {
        let query = Firestore.firestore()
            .collection("cars")
            .whereField("owners", arrayContains: targetUserId)
        
        listener = query.addSnapshotListener { [weak self] snapshot, error in
            guard let self = self else { return }
            
            if let error = error {
                self.loadError = error
                return
            }
            
            self.cars = snapshot?.documents.compactMap {
                try? $0.data(as: Car.self)
            } ?? []
        }
    }
    
    private func stopListening() {
        listener?.remove()
    }
}

2. 在View中使用Provider：

import SwiftUI
import FirebaseAuth

struct TestView: View {
    @StateObject private var carsProvider: CarsProvider
    private let currentUserId: String
    
    init() {
        // 从Firebase Auth获取当前用户UID，做空值处理
        currentUserId = Auth.auth().currentUser?.uid ?? ""
        // 用StateObject初始化Provider，保证View生命周期内实例唯一
        _carsProvider = StateObject(wrappedValue: CarsProvider(userId: currentUserId))
    }
    
    var body: some View {
        List(carsProvider.cars) { car in
            Text(car.name) // 假设Car模型包含name属性
        }
        .alert(item: $carsProvider.loadError) { error in
            Alert(title: Text("加载失败"), message: Text(error.localizedDescription))
        }
    }
}

方案二：封装@FirestoreQuery到可复用View（适合轻量复用）

如果只是想复用查询逻辑而非完全迁移到ObservableObject，可以把@FirestoreQuery封装到独立View中：

struct UserCarsListView: View {
    @FirestoreQuery private var cars: [Car]
    
    init(userId: String) {
        _cars = FirestoreQuery(
            collectionPath: "cars",
            predicates: [.whereField("owners", arrayContains: userId)]
        )
    }
    
    var body: some View {
        List(cars) { car in
            Text(car.name)
        }
    }
}

// 在TestView中调用
struct TestView: View {
    private let currentUserId = Auth.auth().currentUser?.uid ?? ""
    
    var body: some View {
        UserCarsListView(userId: currentUserId)
    }
}

关键注意事项 #

• 必须用@StateObject在View中初始化CarsProvider，不能在body或其他临时方法中创建，否则会重复生成实例。
• 手动监听时一定要在deinit中移除监听，防止内存泄漏。
• 处理查询错误并通过@Published暴露，便于View层展示错误提示。

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