SwiftUI：事件触发间接修改变量时UI不更新的解决方法

在事件驱动的SwiftUI应用中，MainExportMenu视图由ExportController控制。点击按钮触发ExportController在其他线程生成文档，文档就绪后通过事件框架调用receive方法，此时需要切换isReadyForExport的值来显示Spinner组件。

当前问题：

• 直接在按钮调用的generate方法中修改isReadyForExport，UI能正常更新
• 通过事件触发的receive方法修改该值时，UI无响应
• 已尝试的排查：确认ExportController是同一实例、检查线程并手动切换主线程、替换@StateObject为@ObservedObject，均无效

相关代码 #

视图代码

struct MainExportMenu: View {
    @StateObject var exportController = ExportController()

    var body: some View {
        Button(action: {
            exportController.generate(IDs: self.IDs, as: self.exportType)
        }) {
            Text("生成文档")
        }

        if exportController.isReadyForExport {
            Spinner()
        }
    }
}

控制器代码

class ExportController: ObservableObject {
    init() {
        app.add(self) // 将自身注册到事件框架，框架会持有引用
    }
    
    deinit {
        app.remove(self) // 从事件框架移除引用
    }
    
    @Published var isReadyForExport = false {
        didSet {
            self.objectWillChange.send()
        }
    }
    
    // 事件框架触发此方法，确认已被调用，但UI不更新
    func receive(_ event: Events.Event) -> Bool {
        print("已接收事件数据")
        self.isReadyForExport = true // 赋值成功但UI无变化
        return true
    }

    func generate(IDs exportIds: [UUID], as exportType: ExportType?) {
        // 此处直接赋值isReadyForExport = true 可以正常更新UI
        prepareDocuments(exportIds: exportIds, exportType: exportType) // 触发后台任务，完成后会通过事件调用receive
    }
}

解决方案 #

问题根源

1. @Published属性会自动在值变更前发送objectWillChange事件，手动在didSet中调用会导致事件发送时机冲突，干扰SwiftUI的订阅逻辑
2. 事件框架调用receive方法的线程可能不是主线程，即使属性值变更，非主线程的状态更新无法触发SwiftUI视图刷新

修复步骤

1. 移除@Published属性didSet中的手动objectWillChange.send()调用
2. 在receive方法中强制切换到主线程更新属性值

修改后的控制器代码

class ExportController: ObservableObject {
    init() {
        app.add(self)
    }
    
    deinit {
        app.remove(self)
    }
    
    // 去掉didSet中的手动事件发送，@Published会自动处理
    @Published var isReadyForExport = false
    
    func receive(_ event: Events.Event) -> Bool {
        print("已接收事件数据")
        // 强制切换到主线程更新属性
        DispatchQueue.main.async {
            self.isReadyForExport = true
        }
        return true
    }

    func generate(IDs exportIds: [UUID], as exportType: ExportType?) {
        prepareDocuments(exportIds: exportIds, exportType: exportType)
    }
}

额外验证点

• 可在init和receive方法中打印self的内存地址，确认事件框架调用的是同一个ExportController实例，避免因实例不一致导致的UI更新失效

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