SwiftUI中从异步方法更新@State变量失效问题排查

核心问题 #

你遇到的打印值不一致、视图不更新这两个现象，本质都是**@State不适合存储引用类型（类实例）**导致的。@State是为值类型设计的，SwiftUI对其存储的引用类型的更新逻辑有特殊处理，会引发一系列异常行为。

为什么打印值不一致？ #

当你在@MainActor方法中执行self.data = data时，@State的内部更新并非完全同步即时。SwiftUI会对@State的更新进行批处理或延迟提交到视图更新周期，导致赋值后立即访问self.data时，拿到的可能还是旧的数组引用，而非刚赋值的新数组。这就解释了两次打印的someProperty值不一致——你实际打印的是两个不同数组里的对象。

为什么视图不更新？ #

即使成功替换了@State中的数组引用，@State对引用类型的变更检测逻辑也不稳定：

1. 若新数组中的对象引用与旧数组完全一致，List的id: \.self（基于对象引用地址）会认为数据源无变化，不会触发刷新。
2. 即使引用变化，@State对引用类型的更新通知也可能无法被SwiftUI视图系统正确捕获。

正确解决方案 #

改用ObservableObject配合@StateObject管理引用类型数据，这是SwiftUI中管理类实例数据源的标准方式：

1. 将SomeClass改为可观察对象

给需要触发视图更新的属性添加@Published标记：

class SomeClass: ObservableObject {
    @Published var someText: String
    var someProperty: Int
    
    init(someText: String, someProperty: Int) {
        self.someText = someText
        self.someProperty = someProperty
    }
}

2. 创建独立视图模型（ViewModel）

用@Published管理数据数组，统一处理数据获取逻辑：

class ContentViewModel: ObservableObject {
    @Published var data = [SomeClass]()
    
    func fetchData() async {
        let newData = await SomeService.getAll()
        self.data = newData
        // 此时两次打印值会完全一致
        print(newData.first?.someProperty)
        print(self.data.first?.someProperty)
    }
}

3. 在视图中使用@StateObject绑定视图模型

struct ContentView: View {
    @StateObject private var viewModel = ContentViewModel()

    var body: some View {
        List(viewModel.data, id: \.self) { item in
            Text(item.someText)
        }
    }

    func fetchDataSync() {
        // 无需额外detached，Task会自动切换到@MainActor执行fetchData
        Task {
            await viewModel.fetchData()
        }
    }
}

额外说明 #

• @StateObject会在视图生命周期内保持唯一实例，确保数据的持续性和一致性。
• 若SomeClass的内部属性变化需要触发视图更新，必须用@Published标记；如果someProperty的变化也需要更新视图，同样要添加@Published。
• 移除Task.detached，直接使用Task { ... }即可——fetchData被@MainActor标记，会自动切换到主线程执行，无需手动分离任务。

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