iOS 17.4中SwiftData启动崩溃：‘default’配置无实体

问题现象 #

升级到iOS 17.4后，iPhone和iPad端App启动直接崩溃，核心报错信息如下：

error: Store failed to load. <NSPersistentStoreDescription: 0x300488120> (type: SQLite, url: file:///dev/null) with error = Error Domain=NSCocoaErrorDomain Code=134060 "A Core Data error occurred." UserInfo={NSLocalizedFailureReason=The configuration named 'default' does not contain any entities.}

崩溃发生在_SwiftData_SwiftUI/ModelContainer+Extensions.swift内部，而非自定义ModelContainer初始化代码的fatalError分支。

解决方案 #

1. 显式绑定配置名称与实体 #

iOS 17.4对SwiftData配置的关联逻辑有变更，需在创建ModelConfiguration时明确指定名称，确保实体与配置绑定：

private init() {
    let configuration = ModelConfiguration(
        name: "default", // 显式指定配置名称
        isStoredInMemoryOnly: false,
        allowsSave: true,
        groupContainer: .identifier(identifier)
    )

    do {
        self.container = try ModelContainer(
            for: SDEntry.self, SDTag.self, SDSavedFilter.self,
            configurations: configuration
        )
    } catch let error {
        fatalError(error.localizedDescription)
    }        
}

同时检查实体类，确保所有实体都关联到该配置（若实体未显式指定配置，默认就是"default"，但显式声明更稳妥）：

@Model(configuration: "default")
class SDEntry {
    // 实体属性定义
}

2. 确保SwiftUI视图使用自定义容器 #

避免系统自动创建默认容器，在App入口显式注入自定义的ModelContainer：

@main
struct YourApp: App {
    let store = YourStore.shared

    var body: some Scene {
        WindowGroup {
            ContentView()
                .modelContainer(store.container) // 强制使用自定义容器
        }
    }
}

3. 清理旧缓存数据（测试用） #

若为旧缓存数据冲突导致的问题，可通过以下方式清理：

• 在Xcode设备管理中，找到对应App的容器，删除App Group文件夹内的SwiftData相关文件（.sqlite、.sqlite-shm、.sqlite-wal）
• 直接卸载重装App，彻底清除旧缓存

4. 验证步骤 #

1. 执行上述修改后，清理Xcode缓存（Cmd+Shift+K）
2. 重新编译运行至iOS 17.4设备
3. 检查是否仍出现崩溃及配置无实体的报错

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