SwiftUI中如何在后台线程调用API并更新视图？

问题背景 #

使用SwiftUI结合@Observable视图模型实现MVVM架构时，调用API方法出现警告：Main actor-isolated property 'discoverApiViewModel' can not be referenced from a Sendable closure; this is an error in Swift 6，且应用从后台激活时触发主线程相关异常。原代码混合使用GCD和Swift Concurrency，导致线程访问冲突。

核心原因 #

1. @Observable类默认属于Main Actor隔离，其所有属性和方法只能在主线程访问，后台队列直接调用会触发跨线程访问警告。
2. 原代码混用DispatchQueue和Task，线程管理逻辑混乱，导致UI属性更新时可能不在主线程，引发运行时异常。

实现方案 #

1. 重构视图模型：用Swift Concurrency替代GCD #

将API调用方法改为异步方法，网络请求在后台执行，UI属性更新强制切回主线程：

@Observable class DiscoverAPIViewModel {
    private(set) var contentRecsVideosByKeyword: [VideoData] = []
    
    // 异步API调用方法
    func fetchContentRecsVideosByKeyword(accessToken: String, username: String, keyword: String, count: Int = 5) async {
        // 后台执行网络请求（自动调度到非主线程）
        let apiResult = await performAPICall(accessToken: accessToken, username: username, keyword: keyword, count: count)
        
        // 强制在主线程更新UI属性
        await MainActor.run {
            contentRecsVideosByKeyword = apiResult.data ?? []
        }
    }
    
    // 封装实际网络请求逻辑（异步）
    private func performAPICall(accessToken: String, username: String, keyword: String, count: Int) async -> APIResponse {
        // 替换为真实API调用，这里模拟延迟和返回数据
        try? await Task.sleep(for: .seconds(1))
        return APIResponse(data: [VideoData(name: "推荐视频1"), VideoData(name: "推荐视频2")])
    }
}

// 模拟数据结构（根据实际业务调整）
struct VideoData: Identifiable {
    let id = UUID()
    let name: String
}

struct APIResponse {
    let data: [VideoData]?
}

2. 重构视图：统一使用Swift Concurrency #

移除视图中DispatchQueue的调用，直接在.task闭包里调用异步API方法：

struct ApiView: View {
    @State private var discoverApiViewModel = DiscoverAPIViewModel()
    private let keyword: String
    private let username: String
    private let accessToken: String
    private let videoCountPerPage = 7
    private let durationMilliseconds: Duration = .milliseconds(500)
    
    init(username: String, accessToken: String, keyword: String) {
        self.username = username
        self.accessToken = accessToken
        self.keyword = keyword
    }
    
    var body: some View {
        List(discoverApiViewModel.contentRecsVideosByKeyword) { item in
            Text(item.name)
        }
        .task {
            // 延迟执行（模拟业务需求）
            try? await Task.sleep(for: durationMilliseconds)
            // 直接调用异步方法，Swift自动管理线程
            await discoverApiViewModel.fetchContentRecsVideosByKeyword(
                accessToken: accessToken,
                username: username,
                keyword: keyword,
                count: videoCountPerPage
            )
        }
    }
}

3. 重构任务创建函数：移除GCD依赖 #

func createApiTask(viewModel: DiscoverAPIViewModel, 
                   accessToken: String, 
                   username: String, 
                   keyword: String, 
                   videoCountPerPage: Int,
                   durationMilliseconds: Duration) -> Task<Void, Error> {
    Task(priority: .background) {
        try await Task.sleep(for: durationMilliseconds)
        // 直接调用异步API方法，无需手动切换队列
        await viewModel.fetchContentRecsVideosByKeyword(
            accessToken: accessToken,
            username: username,
            keyword: keyword,
            count: videoCountPerPage
        )
    }
}

关键改进点 #

• 统一线程模型：全程使用Swift Concurrency的async/await替代GCD，消除线程管理混乱。
• 线程安全更新：通过MainActor.run确保UI属性更新在主线程执行，符合@Observable的隔离要求。
• 消除警告与异常：避免在后台闭包中直接访问Main Actor隔离的视图模型，彻底解决Sendable警告和主线程异常。

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