Swift结合Firestore实现UITableView滚动分页的最佳方案咨询

嘿，我来帮你搞定这个分页加载的需求！结合Swift和Firestore实现滚动到底部自动加载下一页，咱们一步步调整你的代码，既避免一次性加载全部数据，又能保证流畅的用户体验。

第一步：添加分页必要的变量 #

首先在你的MainTableViewController里加两个关键变量，用来管理分页状态：

// 记录上一页的最后一条文档（Firestore分页的游标）
private var lastDocumentSnapshot: DocumentSnapshot?
// 防止重复触发加载请求的标志
private var isLoading = false

第二步：修改Firestore数据查询方法，支持分页 #

把你原来的ListingdownloadITemsFromFirebase方法改成支持基于游标分页的版本，这样就能每次加载下10条数据：

func listingDownloadItemsFromFirebase(lastDocument: DocumentSnapshot?, completion: @escaping (_ items: [Item], _ newLastDocument: DocumentSnapshot?) -> Void) {
    // 如果正在加载，直接返回，避免重复请求
    guard !isLoading else {
        completion([], nil)
        return
    }
    isLoading = true
    
    // 基础查询：筛选KISCAR为true的条目，按发布时间倒序，每次取10条
    var query = FirebaseReference(.Items)
        .whereField(KISCAR, isEqualTo: true)
        .order(by: kDATEPOSTED, descending: true)
        .limit(to: 10)
    
    // 如果有上一页的最后文档，就从这个文档之后开始查询（核心分页逻辑）
    if let lastDoc = lastDocument {
        query = query.start(afterDocument: lastDoc)
    }
    
    query.getDocuments { [weak self] snapshot, error in
        guard let self = self else { return }
        // 不管请求成功失败，都把加载状态重置
        defer { self.isLoading = false }
        
        guard let snapshot = snapshot, !snapshot.isEmpty else {
            completion([], nil)
            return
        }
        
        var newItems: [Item] = []
        for itemDict in snapshot.documents {
            newItems.append(Item(_dictionary: itemDict.data() as NSDictionary))
        }
        
        // 记录当前页的最后一条文档，作为下一页的游标
        let newLastDocument = snapshot.documents.last
        completion(newItems, newLastDocument)
    }
}

第三步：修改初始加载和添加下一页加载方法 #

更新初始加载方法，同时新增加载下一页的逻辑：

private func loadListingItems() {
    // 初始加载第一页，传nil表示从第一条开始
    listingDownloadItemsFromFirebase(lastDocument: nil) { [weak self] items, lastDoc in
        guard let self = self else { return }
        print("初始加载了 \(items.count) 条数据")
        self.itemArray = items
        self.lastDocumentSnapshot = lastDoc
        self.tableView1.reloadData()
    }
}

private func loadNextPage() {
    // 只有存在上一页的游标且不在加载中，才触发下一页加载
    guard let lastDoc = lastDocumentSnapshot, !isLoading else {
        return
    }
    
    listingDownloadItemsFromFirebase(lastDocument: lastDoc) { [weak self] items, newLastDoc in
        guard let self = self else { return }
        print("加载下一页，新增 \(items.count) 条数据")
        // 把新数据追加到现有数组，而不是替换
        self.itemArray.append(contentsOf: items)
        self.lastDocumentSnapshot = newLastDoc
        self.tableView1.reloadData()
    }
}

第四步：监听UITableView滚动，触发分页加载 #

实现UIScrollView的代理方法，监听滚动位置，当用户接近底部时自动加载下一页：

extension MainTableViewController: UIScrollViewDelegate {
    func scrollViewDidScroll(_ scrollView: UIScrollView) {
        // 计算当前滚动位置与底部的距离
        let offsetY = scrollView.contentOffset.y
        let contentHeight = scrollView.contentSize.height
        let frameHeight = scrollView.frame.size.height
        
        // 当距离底部200pt时触发加载（可以根据你的UI调整这个阈值）
        if offsetY > contentHeight - frameHeight - 200 {
            loadNextPage()
        }
    }
}

最后：别忘了设置代理 #

在viewDidLoad里给tableView设置代理，这样滚动监听才会生效：

override func viewDidLoad() {
    super.viewDidLoad()
    tableView1.delegate = self // 必须设置这一行！
    loadListingItems()
}

关键注意点 #

• Firestore的start(afterDocument:)是分页的最佳实践，比用offset高效得多，因为offset会跳过前面所有文档，而游标方式直接定位到下一页起始位置。
• isLoading标志非常重要，能避免用户快速滚动时触发多次重复的网络请求。
• 滚动触发的阈值（200pt）可以根据你的需求调整，提前加载能让用户感觉更流畅，不会出现等待空白。
• 用[weak self]避免循环引用，防止内存泄漏。

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