如何仅在App首次启动时初始化SwiftData实例？求解决相关报错

问题根源 #

你遇到的错误是因为@Environment(\.modelContext)在App结构体中获取的上下文，并没有关联到你在View层级设置的modelContainer（包含TexEmoji模型），导致插入实例时上下文无法识别该模型。

正确实现方案 #

步骤1：在App结构体中创建并持有ModelContainer #

直接在App中初始化包含所有需要模型的ModelContainer，确保上下文与模型绑定。

步骤2：在App初始化时处理首次启动逻辑 #

避免在onAppear中执行数据插入，改为在App初始化时完成，确保上下文已准备就绪。

步骤3：正确保存上下文修改 #

插入实例后需要调用context.save()（处理可能的错误），确保数据持久化。

修改后的完整代码：

模型代码（无需修改）

@Model
class TexEmoji {
    let id: UUID
    var text: String
    var emoji: String
    
    init(text: String, emoji: String) {
        self.id = UUID()
        self.text = text
        self.emoji = emoji
    }
}

// 假设你的其他模型Ergebnis、Seite定义如下（如果已有则忽略）
@Model
class Ergebnis {}
@Model
class Seite {}

@main App代码修改

@main
struct PersonalAdviceApp: App {
    // 直接创建并持有ModelContainer
    private let modelContainer: ModelContainer
    
    init() {
        do {
            // 初始化包含所有模型的容器
            modelContainer = try ModelContainer(for: [Ergebnis.self, Seite.self, TexEmoji.self])
            // 处理首次启动逻辑
            checkFirstLaunch()
        } catch {
            fatalError("Failed to initialize ModelContainer: \(error)")
        }
    }
    
    func checkFirstLaunch() {
        let hasLaunchedBefore = UserDefaults.standard.bool(forKey: "hasLaunchedBefore")
        guard !hasLaunchedBefore else { return }
        
        // 从容器中获取上下文
        let context = modelContainer.mainContext
        
        // 创建并插入实例
        let instance1 = TexEmoji(text: "Standard-Text 1", emoji: "😃")
        let instance2 = TexEmoji(text: "Home-Page", emoji: "🏠")
        context.insert(instance1)
        context.insert(instance2)
        
        // 保存上下文修改
        do {
            try context.save()
            // 标记已启动过
            UserDefaults.standard.set(true, forKey: "hasLaunchedBefore")
        } catch {
            print("Failed to save initial data: \(error)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            TestPage()
                // 使用已创建的modelContainer
                .modelContainer(modelContainer)
        }
    }
}

关键修改点说明 #

• 直接持有ModelContainer：确保上下文与包含所有模型的容器绑定，避免Environment获取时机问题。
• 初始化时执行首次检查：在App启动阶段就完成数据初始化，无需依赖View的生命周期。
• 显式保存上下文：插入实例后必须调用save()，否则数据不会持久化到本地。
• 错误处理：添加了容器初始化和保存操作的错误捕获，方便调试问题。

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