SwiftUI集成Firebase Firestore报错：Type 'QuerySnapshot?' has no member 'documents' 问题排查及修复

你的代码主要有三个核心问题，都是围绕单个文档快照（DocumentSnapshot）和查询快照（QuerySnapshot）的混淆以及语法错误导致的：

1. 混淆了DocumentSnapshot和QuerySnapshot #

你调用的是db.collection("users").document(userID).addSnapshotListener —— 这个方法监听的是单个文档的变化，回调参数是DocumentSnapshot?，而不是QuerySnapshot?。只有查询多个文档（比如collection("users").getDocuments()或者监听整个集合）才会返回QuerySnapshot，它才有documents属性。单个文档快照没有documents数组，直接解析当前文档即可。

2. 参数名与类型名大小写混淆 #

回调里的参数是querySnapshot（小写开头的变量名），你错误地写成了QuerySnapshot（大写开头的类型名），这是语法错误，Swift会认为你在访问类型的静态成员，而不是当前回调的参数。

3. 数据模型与返回值不匹配 #

你的userData定义为[UserData]数组，但实际上你要获取的是单个用户的文档，应该改成单个UserData?（可选类型，处理文档不存在的情况）或者带默认值的UserData。

修复后的完整代码 #

首先修正UsersModel #

import SwiftUI
import Firebase
import FirebaseFirestore
import FirebaseFirestoreSwift

class UsersModel: ObservableObject {
    // 改成单个可选类型，匹配单个用户文档
    @Published var userData: UserData?
    // 注意：这里不再强制解包currentUser，避免未登录时崩溃
    private let userID = Auth.auth().currentUser?.uid
    private var db = Firestore.firestore()
    
    func fetchData() {
        // 先检查用户是否已登录，获取有效userID
        guard let userID = userID else {
            print("用户未登录，无法获取数据")
            return
        }
        
        // 监听单个文档的快照，回调参数是DocumentSnapshot?
        db.collection("users").document(userID).addSnapshotListener { (documentSnapshot, error) in
            // 处理请求错误
            if let error = error {
                print("获取用户数据失败：\(error.localizedDescription)")
                return
            }
            
            // 解析单个文档到UserData模型
            self.userData = try? documentSnapshot?.data(as: UserData.self)
        }
    }
}

可选优化：修正UserData的命名规范 #

你的ImageURl拼写有大小写不一致的问题（不符合Swift小驼峰命名规范），虽然不影响功能，但建议调整：

import SwiftUI
import FirebaseFirestoreSwift

struct UserData: Identifiable, Codable {
    @DocumentID var id: String?
    var username: String
    // 改成小驼峰命名的imageURL，符合Swift规范
    var imageURL: URL
}

额外说明 #

• 如果你的需求是获取多个用户文档（比如符合特定条件的用户列表），那应该使用collection("users").whereField(...)这类查询方法，此时回调参数才是QuerySnapshot?，才能访问documents数组。但根据你的描述，你需要的是当前用户的单个文档，所以上面的修复完全匹配你的需求。
• 使用addSnapshotListener会实时监听文档的变化，如果只需要一次性获取数据，可以换成getDocument(completion:)方法，避免持续监听资源消耗。

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