Preview画布崩溃：EnvironmentObject未正确配置的解决求助

问题背景 #

App可正常构建运行，但Preview画布崩溃，报错信息：

app crashed due to missing environment of type: TaskModel. To resolve this add .environmentObject(TaskModel(...)) to the appropriate preview.

相关代码片段：

视图与Preview代码 #

struct CopyTaskListScreen: View {
    @EnvironmentObject private var taskModel: TaskModel
    
    var body: some View {
        NavigationStack {
            List(taskModel.tasks.sorted(by: <), id: \.key) { task in
                Text(task.value.title)
            }
        }
    }
}
#Preview {
    CopyTaskListScreen()
        .environmentObject(TaskModel(//how to call TaskDataService here?))
}

TaskModel代码 #

@MainActor
class TaskModel: ObservableObject {
    @Published var tasks: [UUID: Task] = [:]
    
    var data: TaskDataService
    
    init(data: ITaskData) {
        self.data = TaskDataService(data: data)
        readTasks()
    }
    
    // 假设的readTasks方法，从data服务加载数据
    func readTasks() {
        Task {
            do {
                let fetchedTasks = try await data.fetchTasks()
                tasks = Dictionary(uniqueKeysWithValues: fetchedTasks.map { ($0.id, $0) })
            } catch {
                // 错误处理
            }
        }
    }
}

@Main入口代码 #

@main
struct mTaskApp: App {
    var body: some Scene {
        WindowGroup {
            MainScreen()
              .environmentObject(TaskModel(data: TaskDataService(data: RemindersDataAdapter())))
        }
    }
}

解决方案 #

崩溃核心是Preview中TaskModel的初始化依赖未正确配置——真实的RemindersDataAdapter可能因系统权限、框架限制等在Preview环境无法正常工作。推荐两种配置方式：

方式一：使用模拟数据适配器（推荐） #

创建模拟的ITaskData实现，返回固定测试数据，让Preview快速加载且稳定：

// 模拟ITaskData协议实现，专门用于Preview
class MockTaskDataAdapter: ITaskData {
    func fetchTasks() async throws -> [Task] {
        // 返回模拟任务数据
        return [
            Task(id: UUID(), title: "预览测试任务1"),
            Task(id: UUID(), title: "预览测试任务2")
        ]
    }
    
    // 实现ITaskData协议的其他方法，按需返回空值或模拟结果
}

修改Preview代码：

#Preview {
    CopyTaskListScreen()
        .environmentObject(TaskModel(data: MockTaskDataAdapter()))
}

方式二：复用真实依赖（仅当真实服务在Preview环境可正常工作时使用） #

如果确认RemindersDataAdapter在Preview环境能正常初始化和工作，可直接复用@Main中的配置：

#Preview {
    CopyTaskListScreen()
        .environmentObject(TaskModel(data: TaskDataService(data: RemindersDataAdapter())))
}

注意事项 #

• 确保TaskModel的readTasks方法在MainActor上下文执行（已通过@MainActor标注类，无需额外处理）
• 模拟适配器需完整实现ITaskData协议的所有方法，避免编译错误

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