为SwiftUI视图添加@EnvironmentObject后触发编译错误求助

问题背景 #

App的环境对象设置如下：

import SwiftUI
class PromptManager: ObservableObject {
    @Published var selectedArtists: Set<String> = Set<String>()
}

@main
struct EnvTestApp: App {
    @StateObject var promptManager: PromptManager = PromptManager()
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(promptManager)
        }
    }
}

该PromptManager用于供App所有视图访问。

在ContentView中编写任务逻辑时触发编译错误：

struct ContentView: View {
    @EnvironmentObject var promptManager: PromptManager
    @State var test:Bool

    var body: some View {
        Button("abc") {
            Task {
                await withTaskGroup(of: Void.self) { group in
                    group.addTask {
                        await doSomeNetwork1()
                        test = false  //<<<报错位置
                    }
                    group.addTask {
                        await doSomeNetwork2()
                        test = false  //<<<报错位置
                    }
                }
            }
        }
    }
}

错误提示：

Main actor-isolated property 'test' can not be mutated from a Sendable closure

解决方案 #

以下几种方式均可解决该错误：

方式1：用MainActor.run切换主线程修改属性 #

在子任务中修改test时，通过MainActor.run显式切换回主线程：

struct ContentView: View {
    @EnvironmentObject var promptManager: PromptManager
    @State var test: Bool = false // 补充@State属性初始值，原代码缺省会报错

    var body: some View {
        Button("abc") {
            Task {
                await withTaskGroup(of: Void.self) { group in
                    group.addTask {
                        await doSomeNetwork1()
                        await MainActor.run {
                            test = false
                        }
                    }
                    group.addTask {
                        await doSomeNetwork2()
                        await MainActor.run {
                            test = false
                        }
                    }
                }
            }
        }
    }
}

// 示例网络请求函数
func doSomeNetwork1() async {}
func doSomeNetwork2() async {}

方式2：给子任务闭包标注@MainActor #

如果子任务中大部分操作需要在主线程执行，直接给闭包添加@MainActor标注：

struct ContentView: View {
    @EnvironmentObject var promptManager: PromptManager
    @State var test: Bool = false

    var body: some View {
        Button("abc") {
            Task {
                await withTaskGroup(of: Void.self) { group in
                    group.addTask { @MainActor in
                        await doSomeNetwork1()
                        test = false
                    }
                    group.addTask { @MainActor in
                        await doSomeNetwork2()
                        test = false
                    }
                }
            }
        }
    }
}

方式3：提取状态修改逻辑到@MainActor方法 #

若状态修改逻辑复杂，可单独抽成标注@MainActor的方法：

struct ContentView: View {
    @EnvironmentObject var promptManager: PromptManager
    @State var test: Bool = false

    var body: some View {
        Button("abc") {
            Task {
                await withTaskGroup(of: Void.self) { group in
                    group.addTask {
                        await doSomeNetwork1()
                        await updateTestState()
                    }
                    group.addTask {
                        await doSomeNetwork2()
                        await updateTestState()
                    }
                }
            }
        }
    }

    @MainActor private func updateTestState() {
        test = false
    }
}

错误原因说明 #

SwiftUI的@State属性默认是主线程隔离的，仅允许在主线程修改。而TaskGroup的子任务默认在后台线程执行，直接在子任务闭包中修改test会违反主线程隔离规则，从而触发编译错误。上述方案均通过显式切换回主线程，满足@State属性的访问要求。

另外注意：原代码中@State var test:Bool未提供初始值，这也是编译报错的潜在问题，需要补充初始值（如false）才能正常编译。

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