SwiftData插入数据遇ModelContext及Query错误，求正确实现方法

问题重现 #

尝试在SwiftData中插入新条目时，遇到以下错误：

Accessing Environment's value outside of being installed on a View. This will always read the default value and will not update.
Set a .modelContext in view's environment to use Query

原代码因环境变量访问时机错误、上下文注入不规范等问题，导致数据无法正常添加。

错误原因分析 #

1. View初始化阶段访问环境变量：在TestContent的init方法中直接调用modelContext，此时View尚未挂载到视图树，环境上下文还未注入，拿到的是默认无效值。
2. @Query依赖未就绪：@Query需要环境中已存在有效的modelContext，但init阶段环境未初始化完成，导致查询失败。
3. 冗余的ModelContainer：EditTestItem重复添加.modelContainer，会导致上下文不一致，无需在子视图中重复声明。
4. 绑定值使用错误：Text($testData.id)错误地传入了绑定值，Text组件需要直接传入字符串值。

修正后的完整代码 #

import SwiftUI
import SwiftData

@Model
class TestData {
    @Attribute(.unique) var id: String
    var value: String
    init(id: String, value: String) {
        self.id = id
        self.value = value
    }
}

struct EditTestItem: View {
    @Bindable var testData: TestData
    var body: some View {
        VStack {
            HStack {
                // 修复：直接使用属性值而非绑定值
                Text(testData.id)
                TextField("Enter Data Here", text: $testData.value)
            }
        }
        // 移除冗余的modelContainer，父视图已提供上下文
    }
}

struct TestContent: View {
    let testID: String
    @Environment(\.modelContext) private var modelContext
    @Query var testData: [TestData]
    // 使用@State存储临时条目，避免init阶段创建
    @State private var testItem: TestData?
    
    init(testID: String) {
        self.testID = testID
        // 初始化阶段只处理参数，不操作上下文
    }
    
    var body: some View {
        VStack {
            VStack {
                Text(testID)
                Text("总条目数: \(testData.count)")
                if let testItem = testItem {
                    EditTestItem(testData: testItem)
                }
            }
            Button("添加/保存条目") {
                // 先检查是否已存在相同id的条目
                let existingItem = testData.first { $0.id == testID }
                if let existingItem {
                    // 存在则直接使用现有条目
                    testItem = existingItem
                } else {
                    // 不存在则创建新条目并插入上下文
                    let newItem = TestData(id: testID, value: "New value: \(testID)")
                    modelContext.insert(newItem)
                    testItem = newItem
                }
                
                // 保存上下文
                do {
                    try modelContext.save()
                } catch {
                    print("保存失败: \(error.localizedDescription)")
                }
            }
        }
        .modelContainer(for: TestData.self)
        .onAppear {
            // 视图加载后可执行初始化查询或其他操作
        }
    }
}

#Preview {
    TestContent(testID: "b")
        .modelContainer(for: TestData.self, inMemory: true)
        .frame(width: 400)
}

关键修改点说明 #

• 环境变量访问时机：将数据插入逻辑移到按钮点击事件中（或onAppear），此时View已挂载，modelContext已正常注入。
• 移除冗余配置：删除子视图EditTestItem中的.modelContainer，复用父视图的上下文。
• 修复绑定值错误：将Text($testData.id)改为Text(testData.id)，符合Text组件的参数要求。
• 添加存在性检查：恢复了原代码中移除的条目存在性检查逻辑，避免重复插入唯一约束的条目。
• 预览优化：预览中添加inMemory: true，避免影响持久化数据。

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