Firebase中数组追加问题：异步特性与reloadData()

我之前也踩过Firebase异步嵌套监听的坑，太懂这种刚追加完数据就“消失”的抓狂感了！结合你的描述，给你几个针对性的排查和解决方向：

1. 先确认数组的生命周期和引用类型 #

首先检查你的users数组是不是方法内的局部变量？如果selectUsersComp每次调用都重新初始化users，那Firebase闭包里的追加操作只是在闭包的局部上下文里修改，方法执行完数组就被销毁了。

一定要把users声明为类的实例变量（比如ViewController的属性），确保闭包能捕获到同一个数组引用：

class YourViewController: UIViewController {
    // 把数组放在类级别，确保生命周期和VC一致
    var users: [Comp] = []
    
    func selectUsersComp() {
        // 这里不再重新初始化users，直接操作已有数组
        let ref = Database.database().reference().child("users")
        ref.observe(.value) { [weak self] snapshot in
            guard let self = self else { return }
            // 处理数据...
        }
    }
}

2. 修复嵌套监听的逻辑问题 #

嵌套observe是大坑——外层监听每次触发时，都会给内层节点添加新的监听，导致重复回调、数据重复甚至内存泄漏。

优化方案： #

• 如果只需要获取一次数据，用observeSingleEvent(of:)替代持续监听的observe(.value)，避免重复注册：

ref.observeSingleEvent(of: .value) { [weak self] snapshot in
    guard let self = self else { return }
    // 遍历用户节点
    for child in snapshot.children {
        guard let userSnapshot = child as? DataSnapshot else { continue }
        // 内层也用一次性监听
        let compRef = Database.database().reference().child("comps").child(userSnapshot.key)
        compRef.observeSingleEvent(of: .value) { compSnapshot in
            if let compData = compSnapshot.value as? [String: Any] {
                let comp = Comp(data: compData)
                DispatchQueue.main.async {
                    self.users.append(comp)
                    self.collectionView.reloadData()
                }
            }
        }
    }
}

• 如果必须用持续监听，一定要在合适的时机移除监听（比如viewWillDisappear），避免多次注册：

var userRefHandle: DatabaseHandle?
var compRefHandles: [DatabaseHandle] = []

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    if let handle = userRefHandle {
        Database.database().reference().child("users").removeObserver(withHandle: handle)
    }
    compRefHandles.forEach { handle in
        Database.database().reference().child("comps").removeObserver(withHandle: handle)
    }
}

3. 确保主线程刷新的时机正确 #

你提到用了Dispatch.main.async但没解决问题，大概率是刷新时机不对——比如你在闭包外面调用了reloadData，而此时数组还没被修改。

正确的做法是每次数据追加完成后，立刻在主线程刷新UI，并且要捕获正确的self避免循环引用：

compRef.observeSingleEvent(of: .value) { [weak self] compSnapshot in
    guard let self = self else { return }
    guard let compData = compSnapshot.value as? [String: Any],
          let comp = Comp(data: compData) else { return }
    
    // 必须在主线程修改UI相关的数组并刷新
    DispatchQueue.main.async {
        self.users.append(comp)
        self.collectionView.reloadData()
    }
}

4. 避免.value事件的全量覆盖问题 #

如果外层用的是.value事件，每次回调都会返回节点的全量数据，如果你在回调里没有先清空数组，直接追加的话会导致数据重复。但反过来，如果每次都清空数组，内层的异步追加可能还没完成就被清空了——这也是数据“消失”的常见原因。

解决方法：

• 先清空数组，然后用DispatchGroup等待所有内层异步操作完成后再刷新UI：

func selectUsersComp() {
    let ref = Database.database().reference().child("users")
    ref.observeSingleEvent(of: .value) { [weak self] snapshot in
        guard let self = self else { return }
        self.users.removeAll() // 先清空旧数据
        let group = DispatchGroup()
        
        for child in snapshot.children {
            guard let userSnapshot = child as? DataSnapshot else { continue }
            group.enter()
            let compRef = Database.database().reference().child("comps").child(userSnapshot.key)
            compRef.observeSingleEvent(of: .value) { compSnapshot in
                defer { group.leave() }
                if let compData = compSnapshot.value as? [String: Any],
                   let comp = Comp(data: compData) {
                    self.users.append(comp)
                }
            }
        }
        
        // 所有异步操作完成后，主线程刷新UI
        group.notify(queue: .main) {
            self.collectionView.reloadData()
        }
    }
}

5. 用Async/Await扁平化异步代码（iOS 15+） #

如果你的项目支持iOS 15及以上，用Swift的Async/Await可以彻底解决嵌套闭包的回调地狱，逻辑更清晰也更容易排查问题：

func selectUsersComp() async {
    let ref = Database.database().reference().child("users")
    do {
        let snapshot = try await ref.observeSingleEvent(of: .value)
        self.users.removeAll()
        
        for child in snapshot.children {
            guard let userSnapshot = child as? DataSnapshot else { continue }
            let compRef = Database.database().reference().child("comps").child(userSnapshot.key)
            let compSnapshot = try await compRef.observeSingleEvent(of: .value)
            if let compData = compSnapshot.value as? [String: Any],
               let comp = Comp(data: compData) {
                self.users.append(comp)
            }
        }
        
        // 主线程刷新UI
        DispatchQueue.main.async {
            self.collectionView.reloadData()
        }
    } catch {
        print("获取数据失败：\(error)")
    }
}

// 调用时用async/await
Task {
    await selectUsersComp()
}

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