Swift中TextField内容变更时异步调用方法致UI冻结的解决办法

核心问题拆解 #

1. 无请求防抖：每输入一个字符就发起请求，短时间内大量并发请求占用资源，拖慢UI响应
2. 旧请求未取消：旧请求可能晚于新请求返回，覆盖最新结果，同时浪费系统资源
3. 异步方法不规范：如果searchService.GetData内部用了同步网络调用，会直接阻塞主线程
4. Actor上下文错误：ViewModel未绑定主线程时，更新UI属性可能不在主线程，导致异常

分步解决方案 #

1. 给ViewModel标记@MainActor

确保所有UI相关属性的变更都在主线程执行：

@MainActor
class SearchViewModel: ObservableObject {
    @Published var results: ResultsData = ResultsData()
    @Published var searchTerm: String = "a search term"
    
    private let searchService: SearchService
    private var searchTask: Task<Void, Error>?
    private var cancellables = Set<AnyCancellable>()
    
    init(searchService: SearchService) {
        self.searchService = searchService
        setupSearchListener()
    }
}

2. 实现防抖+请求取消逻辑

用Combine的debounce延迟发起请求，同时取消未完成的旧请求，避免资源浪费：

extension SearchViewModel {
    private func setupSearchListener() {
        $searchTerm
            .debounce(for: .milliseconds(500), scheduler: DispatchQueue.main) // 用户停止输入500ms后再请求
            .removeDuplicates() // 相同搜索词跳过重复请求
            .sink { [weak self] term in
                self?.performSearch(with: term)
            }
            .store(in: &cancellables)
    }
    
    private func performSearch(with term: String) {
        // 取消之前未完成的请求
        searchTask?.cancel()
        
        searchTask = Task {
            do {
                guard !term.isEmpty else {
                    self.results = ResultsData() // 空搜索词清空结果
                    return
                }
                
                let searchResults = try await searchService.GetData(searchTerm: term)
                // 检查任务是否已取消，避免更新过时结果
                guard !Task.isCancelled else { return }
                
                self.results = searchResults
            } catch {
                // 忽略取消错误，处理其他异常
                if !(error is CancellationError) {
                    print("搜索失败: \(error.localizedDescription)")
                    // 可在此处添加UI错误提示逻辑
                }
            }
        }
    }
}

3. 确保搜索服务是真正的异步实现

避免在异步方法内使用同步阻塞代码，必须用async/await风格的网络请求：

class SearchService {
    func GetData(searchTerm: String) async throws -> ResultsData {
        // 对搜索词进行URL编码，避免非法字符
        guard let encodedTerm = searchTerm.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed),
              let url = URL(string: "https://your-api-domain.com/search?term=\(encodedTerm)") else {
            throw NSError(domain: "SearchError", code: 1, userInfo: [NSLocalizedDescriptionKey: "无效的搜索链接"])
        }
        
        // 使用URLSession异步API，不会阻塞线程
        let (data, response) = try await URLSession.shared.data(from: url)
        
        guard let httpResponse = response as? HTTPURLResponse, httpResponse.statusCode == 200 else {
            throw NSError(domain: "SearchError", code: 2, userInfo: [NSLocalizedDescriptionKey: "请求失败"])
        }
        
        // 解析返回数据
        let decoder = JSONDecoder()
        return try decoder.decode(ResultsData.self, from: data)
    }
}

4. 移除原有的didSet实现

删掉searchTerm的didSet代码，改用上面的Combine监听逻辑，更优雅地处理输入和请求生命周期。

额外提示 #

• 防抖时间可根据需求调整（300-1000ms都合理）
• 若不想用Combine，也可以用Task.sleep手动实现防抖，但Combine的方式更简洁
• 务必处理空搜索词的情况，避免发起无效请求

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