为WindowGroup配置ModelContainer时出现NSEntityDescription错误

遇到的错误信息：

'NSInternalInconsistencyException', reason: 'NSFetchRequest could not locate an NSEntityDescription for entity name 'TaskItem''

以下是具体排查方向：

• 检查ModelContainer的作用域：确保ModelContainer正确关联到WindowGroup或整个App场景。当前代码已在WindowGroup后附加.modelContainer(persistenceController.container)，但要避免子视图中添加冲突的容器，同时确认容器初始化时机没有滞后。
• 验证@Model注解有效性：确认TaskItem类顶部的@Model注解没有遗漏、拼写错误，且已正确导入SwiftData框架。
• 修复PersistenceController的错误捕获：当前代码用try!强制解包ModelContainer初始化，会隐藏真实错误。换成do-catch捕获异常，能直接看到初始化失败的具体原因：

  init() {
      do {
          container = try ModelContainer(for: TaskItem.self)
      } catch {
          fatalError("ModelContainer初始化失败：\(error.localizedDescription)")
      }
  }
  

• 确认实体名称完全匹配：检查所有引用TaskItem的代码（包括手动写的FetchRequest字符串），确保拼写和类名完全一致，SwiftData默认以类名作为实体名。
• 清理Xcode缓存：缓存可能导致模型元数据未更新，执行Cmd+Shift+K清理Build Folder后重新编译运行。
• 检查容器传递链路：确保ContentView及其子视图能正确获取到ModelContainer，比如使用@Query的视图必须处于已附加容器的场景层级中。
• 排查依赖注入的时序问题：项目使用Swinject做依赖注入，initializeDependencies是异步方法，需避免在ModelContainer初始化完成前就创建依赖SwiftData的ViewModel。可以把异步初始化包裹在Task中：

  init() {
      Task {
          await DIContainer.shared.initializeDependencies()
      }
  }
  

简化后的代码示例 #

TaskItem.swift #

import SwiftUI
import SwiftData

@Model
class TaskItem: Identifiable {
    var id: UUID
    var taskTitle: String
    var creationDate: Date
    var isCompleted: Bool
    var tint: String
    
    init(id: UUID = .init(), taskTitle: String, creationDate: Date = .init(), isCompleted: Bool = false, tint: String) {
        self.id = id
        self.taskTitle = taskTitle
        self.creationDate = creationDate
        self.isCompleted = isCompleted
        self.tint = tint
    }
    
    var tintColor: Color {
        switch tint {
        case "TaskColor 1": return .taskColor1
        case "TaskColor 2": return .taskColor2
        case "TaskColor 3": return .taskColor3
        case "TaskColor 4": return .taskColor4
        case "TaskColor 5": return .taskColor5
        default: return .black
        }
    }
}

DIController.swift #

import Swinject
import Supabase

class DIContainer {
    static let shared = DIContainer()
    let container: Container

    private init() {
        container = Container()
    }

    func initializeDependencies() async {
        container.register(LoginViewModel.self) { resolver in
            LoginViewModel(supabaseClient: supabaseClient)
        }
    }
}

MyApp.swift #

import SwiftUI
import Swinject
import SwiftData

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared

    init() {
        Task {
            await DIContainer.shared.initializeDependencies()
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(DIContainer.shared.container.resolve(LoginViewModel.self)!)
        }
        .modelContainer(persistenceController.container)
    }
}

PersistenceController.swift #

import SwiftData

class PersistenceController {
    static let shared = PersistenceController()
    let container: ModelContainer

    init() {
        do {
            container = try ModelContainer(for: TaskItem.self)
        } catch {
            fatalError("ModelContainer初始化失败：\(error.localizedDescription)")
        }
    }
}

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