SwiftData模型无法保存更改且UI不更新问题排查

问题原因 #

1. SwiftData追踪机制限制：SwiftData仅会追踪@Model标记对象及其关联的@Model对象的变更。你的User是普通类，未标记@Model，因此修改User.id时，SwiftData无法感知到UserGroup的变化，既不会持久化修改，也不会触发UI刷新。
2. 代码中的基础错误：
   • MyViewModel中var userGroup: UserGroup()语法错误，正确声明应为var userGroup: UserGroup
   • Main视图里viewModel!.dataModel是笔误，实际应为viewModel!.userGroup
   • 初始化UserGroup后未将其添加到ModelContext，导致对象根本未被SwiftData纳入管理

解决方案 #

方案一：将User转为@Model并建立关联（推荐，适合需要持久化User的场景） #

把User标记为@Model，并通过@Relationship与UserGroup关联，让SwiftData能追踪User的所有变更：

@Model class User: Codable {
    var id: String
    
    init() {
        self.id = UUID().uuidString
    }
}

@Model class UserGroup {
    // 根据业务需求选择删除规则，比如.cascade表示删除UserGroup时同时删除关联的User
    @Relationship(deleteRule: .cascade)
    var users: [User]
    
    init() {
        self.users = [User()]
    }
}

@Observable class MyViewModel {
    var modelContext: ModelContext
    var userGroup: UserGroup
    
    init(modelContext: ModelContext) {
        self.modelContext = modelContext
        self.userGroup = UserGroup()
        // 必须将对象插入ModelContext，才能被SwiftData管理
        modelContext.insert(userGroup)
    }
    
    func generateNewId() {
        userGroup.users[0].id = UUID().uuidString
        // 可选：立即保存上下文，将修改持久化到本地
        try? modelContext.save()
    }
}

struct Main: View {
    @Environment(\.modelContext) var modelContext
    @State var viewModel: MyViewModel?

    var body: some View {
        ZStack {
            // 用可选绑定替代强制解包，更安全
            if let viewModel = viewModel {
                Text(viewModel.userGroup.users[0].id)
                    .onTapGesture {
                        viewModel.generateNewId()
                    }
            }
        }
        .onAppear { viewModel = MyViewModel(modelContext: modelContext) }
    }
}

方案二：手动通知SwiftData变更（适合User无需持久化的场景） #

如果User不需要存入数据库，仅作为UserGroup的临时数据，修改User后手动标记UserGroup为已更新：

@Observable class User: Codable {
    var id: String
    
    init() {
        self.id = UUID().uuidString
    }
}

@Model class UserGroup {
    var users: [User]
    
    init() {
        self.users = [User()]
    }
}

@Observable class MyViewModel {
    var modelContext: ModelContext
    var userGroup: UserGroup
    
    init(modelContext: ModelContext) {
        self.modelContext = modelContext
        self.userGroup = UserGroup()
        modelContext.insert(userGroup)
    }
    
    func generateNewId() {
        userGroup.users[0].id = UUID().uuidString
        // 手动标记UserGroup为已修改，触发SwiftData的更新机制
        modelContext.update(userGroup)
        try? modelContext.save()
    }
}

方案三：移除UserGroup的@Model标记（适合无需持久化整个UserGroup的场景） #

如果不需要将UserGroup存入本地数据库，直接去掉@Model标记，改用@Observable，此时所有属性变更都会正常触发UI更新：

@Observable class User: Codable {
    var id: String
    
    init() {
        self.id = UUID().uuidString
    }
}

// 去掉@Model，改用@Observable
@Observable class UserGroup {
    var users: [User]
    
    init() {
        self.users = [User()]
    }
}

@Observable class MyViewModel {
    var userGroup: UserGroup
    
    init() {
        self.userGroup = UserGroup()
    }
    
    func generateNewId() {
        userGroup.users[0].id = UUID().uuidString
    }
}

struct Main: View {
    @State var viewModel: MyViewModel?

    var body: some View {
        ZStack {
            if let viewModel = viewModel {
                Text(viewModel.userGroup.users[0].id)
                    .onTapGesture {
                        viewModel.generateNewId()
                    }
            }
        }
        .onAppear { viewModel = MyViewModel() }
    }
}

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