如何移除Firestore分页中addSnapshotListener监听器及解决lastSnapshot为nil问题

首先纠正概念误区：你之前混淆了Query对象与addSnapshotListener返回值的类型：

• 直接构造的ref/first是Query类型，它自带的removeObserver方法适用于其他监听模式，和快照监听器的解绑逻辑不通用
• addSnapshotListener执行后返回的实例才是ListenerRegistration类型，你需要单独持有该实例，解绑时直接调用它的remove()方法即可，无需传入观察者、key path等参数。

给出符合你三个需求（解绑监听、可选查询条件、分页）的代码示例：

// 全局持有三个核心对象
private var currentListener: ListenerRegistration? // 用于解绑监听器
private var currentQuery: Query? // 用于携带whereField等查询条件
private var lastSnapshot: QueryDocumentSnapshot? // 用于分页游标

构造查询、绑定监听的逻辑：

// 构造带可选条件的查询
var ref = db.collection("cities")
    .order(by: "population")
    .limit(to: 25)
if let searchTerm = searchTerm {
    ref = ref.whereField("population", isGreaterThan: searchTerm)
}
currentQuery = ref

// 先移除旧监听器，避免重复回调
currentListener?.remove()
// 绑定新监听器，持有返回的ListenerRegistration实例
currentListener = ref.addSnapshotListener { [weak self] snapshot, error in
    guard let self = self, let snapshot = snapshot else {
        print("查询错误: \(error?.localizedDescription ?? "未知错误")")
        return
    }
    // 处理数据、分页游标逻辑
    guard !snapshot.documents.isEmpty else {
        print("无符合条件的文档")
        return
    }
    self.lastSnapshot = snapshot.documents.last
}

后续你也需要调用next.addSnapshotListener，该方法会返回另一个ListenerRegistration实例，你可以在需要时调用它的remove()方法解绑监听器

加载下一页时，构造next查询后重复上述逻辑即可，新的监听器返回值直接覆盖currentListener即可，记得每次绑定新监听前先移除旧的。

按优先级排查以下原因：

• 你的查询条件没有匹配到任何文档，可先打印snapshot.documents.count确认返回列表长度，如果是0则属于正常业务逻辑，检查whereField的取值范围、集合是否有对应数据即可
• 排序字段population拼写错误，或者部分文档不存在该字段：Firestore会自动过滤缺少排序字段的文档，如果所有匹配条件的文档都没有该字段，就会返回空列表
• 你使用了带includeMetadataChanges参数的监听器重载方法，仅监听元数据变更时返回的文档列表可能为空，可添加判断过滤元数据变更的回调：

currentListener = ref.addSnapshotListener { snapshot, error in
    guard let snapshot = snapshot, 
          !snapshot.metadata.isFromCache,
          !snapshot.metadata.hasPendingWrites else {
        return
    }
    // 后续逻辑
}

• 检查limit参数是否被错误赋值为0，或者查询构造过程中条件被意外覆盖。

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