SwiftUI中向Firestore添加数据报错：DocumentReference需遵循View协议

错误原因 #

你遇到的Static method 'buildExpression' requires that 'DocumentReference' conform to 'View'错误，核心问题是：SwiftUI的body属性必须返回符合View协议的内容，但db.collection("wine").addDocument(...)返回的是DocumentReference类型（不属于View），直接放在body里会触发类型不匹配。

解决方案 #

下面是几种符合SwiftUI架构的正确写法：

1. 视图出现时自动执行（初始化场景）

将Firestore操作放到onAppear生命周期回调中，这是视图首次显示时执行异步操作的标准方式：

import SwiftUI

struct ContentView: View {
    var body: some View {
        Text("hi")
            .onAppear {
                // 执行Firestore添加操作，建议加上错误处理
                db.collection("wine").addDocument(data: [
                    "year": 2017,
                    "type": "pinot-noir",
                    "label": "Peller Estates"
                ]) { error in
                    if let error = error {
                        print("添加文档失败: \(error)")
                    } else {
                        print("文档添加成功")
                    }
                }
            }
    }
}

#Preview {
    ContentView()
}

2. 按钮手动触发（交互场景）

如果需要用户主动触发添加操作，把逻辑放到按钮的点击回调里：

import SwiftUI

struct ContentView: View {
    var body: some View {
        VStack(spacing: 20) {
            Text("hi")
            Button("添加葡萄酒记录") {
                db.collection("wine").addDocument(data: [
                    "year": 2017,
                    "type": "pinot-noir",
                    "label": "Peller Estates"
                ]) { error in
                    if let error = error {
                        print("添加失败: \(error)")
                    } else {
                        print("添加成功")
                    }
                }
            }
        }
    }
}

#Preview {
    ContentView()
}

3. 用ViewModel分离业务逻辑（复杂项目推荐）

遵循MVVM架构，把Firestore操作从视图中分离到ViewModel，让视图只负责UI展示：
首先创建ViewModel类：

import Foundation
import FirebaseFirestore

class WineViewModel: ObservableObject {
    private let db = Firestore.firestore()
    
    func addWine(year: Int, type: String, label: String) {
        db.collection("wine").addDocument(data: [
            "year": year,
            "type": type,
            "label": label
        ]) { error in
            if let error = error {
                print("添加文档出错: \(error)")
            } else {
                print("文档添加完成")
            }
        }
    }
}

然后修改ContentView：

import SwiftUI

struct ContentView: View {
    @StateObject private var viewModel = WineViewModel()
    
    var body: some View {
        Text("hi")
            .onAppear {
                viewModel.addWine(year: 2017, type: "pinot-noir", label: "Peller Estates")
            }
    }
}

#Preview {
    ContentView()
}

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