Swift中Firebase读取数据追加到数组为空问题解决方案

开发者阿泽

2026-8-30

问题根因

你的代码存在3个直接导致@State修饰的employees数组无法正常赋值的问题：

调用时机错误：你在ListFrame的init()构造函数中调用getData()，此时View的@State属性尚未完成初始化，Firebase异步回调执行时，修改的是构造阶段的临时View实例，等View真正完成挂载进入渲染流程时，持有的是全新初始化的State容器，之前异步操作写入的值全部丢失。
数组逻辑错误：你在snapshot.documents.map的遍历闭包内反复执行数组追加操作，map本身就是用来遍历集合生成新数组的方法，在遍历过程中反复把未完成构建的临时数组追加到目标数组，本身就会导致数据重复、逻辑混乱。
线程安全隐患：Firebase的网络回调默认不在主线程执行，即使State初始化完成，非主线程修改@State属性也会导致UI刷新异常、状态不生效。
额外设计缺陷：Employee模型用本地生成的UUID()作为唯一ID，和Firebase服务端存储的文档ID不匹配，后续做编辑、删除、实时同步操作时会出现数据匹配错误。

修复方案

移除init()中调用getData()的逻辑，将数据加载操作移到.onAppear修饰符中执行，此时View已经完成挂载，@State属性初始化完毕，异步回调中的赋值可以正常触发UI刷新。
简化数组转换逻辑：直接通过map遍历所有文档生成完整的员工数组，遍历完成后一次性赋值给employees，不要在遍历过程中执行追加操作。
所有修改@State的操作，显式切换到主线程执行。
修改Employee模型，直接使用Firebase返回的文档ID作为模型唯一ID，避免后续数据不一致。

修正后的核心代码

首先调整Employee模型定义：

struct Employee: Identifiable {
    // 直接使用Firebase文档ID作为唯一标识，不要本地生成UUID
    var id: String
    var firstName: String
    var lastName: String
    var emailID: String
    var education: String
    var department: String
    var address: String
    var salary: String
}

然后调整ListFrame的数据加载逻辑：

struct ListFrame: View {
    
    @State var employees = [Employee]()
    
    func getData() {
        let db = Firestore.firestore()
        db.collection("EmployeeList").getDocuments { snapshot, error in
            // 前置校验错误和空数据
            guard error == nil, let snapshot = snapshot else {
                print("数据读取失败: \(error?.localizedDescription ?? "未知错误")")
                return
            }
            // map直接生成完整员工数组，不要在遍历过程中做追加操作
            let employeesTemp = snapshot.documents.map { document in
                Employee(
                    id: document.documentID,
                    firstName: document["firstName"] as? String ?? "",
                    lastName: document["lastName"] as? String ?? "",
                    emailID: document["emailID"] as? String ?? "",
                    education: document["education"] as? String ?? "",
                    department: document["department"] as? String ?? "",
                    address: document["address"] as? String ?? "",
                    salary: document["salary"] as? String ?? ""
                )
            }
            // 切回主线程更新状态，触发UI刷新
            DispatchQueue.main.async {
                self.employees = employeesTemp
            }
        }
    }
    
    var body: some View {
        NavigationView {
            VStack {
                Spacer()
                
                List {
                    ForEach(employees) { employee in
                        Text(employee.firstName)
                    }
                }
                .navigationTitle("List of Employees")
                
                Spacer()
                
                HStack {
                    Button(action: {}) {
                        NavigationLink(destination: AddEmployeeFrame(employees: $employees)) {
                            Text("Add Employee")
                        }
                    }           
                }
            }
            // 视图挂载完成后再加载数据
            .onAppear {
                self.getData()
            }
        }
    }
}

可选优化

当前新增员工的逻辑是先更新本地数组再等待Firebase返回，建议调整为Firebase写入成功后再更新本地数组，避免网络请求失败时本地数据和服务端不一致：

给addData方法增加完成回调，写入成功后返回带正确文档ID的员工对象
移除保存按钮中提前向employees数组追加数据的逻辑，改为写入成功回调中执行追加操作

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