Swift新手求助：快速切换标签致UITableView因API延迟响应崩溃

Hey there! I totally get this frustration—dealing with async API calls and table views can be tricky when you're starting out with Swift. Let's break down why your app is crashing and fix it for good.

Why This Is Happening #

The core issue here is that when you switch tabs fast, the old API requests you fired off don't just vanish—they keep running in the background. When those requests finally return, they try to update your table view's data source, but by then you've already switched to a different tab. This leads to mismatched data: for example, your data source might be empty (because you switched to a new tab), but the old request tries to populate it and trigger a table refresh, causing errors like row (0) beyond bounds (0) or array index out of range.

Step-by-Step Solutions #

1. Cancel Incomplete API Requests

Never let old requests linger around when switching tabs. Save a reference to the current API task and cancel it before starting a new one. This prevents stale responses from messing with your data.

// 在你的ViewController中声明一个可选的任务变量
private var currentAPITask: URLSessionDataTask?
private var currentSelectedTabIndex = 0
private var currentDataSource: [YourDataModel] = []

// 标签切换的处理方法（比如tabBarController的代理方法，或自定义标签点击事件）
func handleTabSwitch(to index: Int) {
    // 先取消正在进行的请求
    currentAPITask?.cancel()
    currentAPITask = nil
    
    currentSelectedTabIndex = index
    // 重置当前数据源并刷新表格，避免旧请求回来干扰
    currentDataSource = []
    tableView.reloadData()
    
    // 发起新的API请求
    guard let url = URL(string: "your-api-endpoint-for-tab-\(index)") else { return }
    currentAPITask = URLSession.shared.dataTask(with: url) { [weak self] data, response, error in
        guard let self = self, error == nil, let data = data else { return }
        
        // 解析返回的数据
        do {
            let fetchedItems = try JSONDecoder().decode([YourDataModel].self, from: data)
            DispatchQueue.main.async {
                // 只在当前标签是发起请求的标签时，才更新数据
                if self.currentSelectedTabIndex == index {
                    self.currentDataSource = fetchedItems
                    self.tableView.reloadData()
                }
            }
        } catch {
            print("数据解析失败: \(error.localizedDescription)")
        }
    }
    currentAPITask?.resume()
}

2. Cache Tab Data (Optional but Useful)

To avoid reloading data every time you switch back to a tab, store each tab's data in a dictionary. This also ensures you don't waste network calls on data you already have.

// 用字典存储每个标签的缓存数据
private var tabDataCache: [Int: [YourDataModel]] = [:]

// 在handleTabSwitch方法中修改：
func handleTabSwitch(to index: Int) {
    currentAPITask?.cancel()
    currentAPITask = nil
    
    currentSelectedTabIndex = index
    
    // 先检查缓存，如果有数据直接显示
    if let cachedData = tabDataCache[index] {
        currentDataSource = cachedData
        tableView.reloadData()
        return
    }
    
    currentDataSource = []
    tableView.reloadData()
    
    // 发起请求并缓存数据
    guard let url = URL(string: "your-api-endpoint-for-tab-\(index)") else { return }
    currentAPITask = URLSession.shared.dataTask(with: url) { [weak self] data, response, error in
        guard let self = self, error == nil, let data = data else { return }
        
        do {
            let fetchedItems = try JSONDecoder().decode([YourDataModel].self, from: data)
            DispatchQueue.main.async {
                // 缓存数据，不管当前是不是这个标签
                self.tabDataCache[index] = fetchedItems
                if self.currentSelectedTabIndex == index {
                    self.currentDataSource = fetchedItems
                    self.tableView.reloadData()
                }
            }
        } catch {
            print("数据解析失败: \(error.localizedDescription)")
        }
    }
    currentAPITask?.resume()
}

3. Make Table View Data Source Methods Safe

Even with the above fixes, add a quick safety check in your table view data source methods to avoid accidental index out-of-range errors.

func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return currentDataSource.count
}

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "YourCellID", for: indexPath)
    
    // 安全检查：确保row在数据源范围内
    guard indexPath.row < currentDataSource.count else {
        cell.textLabel?.text = ""
        return cell
    }
    
    let item = currentDataSource[indexPath.row]
    cell.textLabel?.text = item.title // 替换成你的数据字段
    return cell
}

Final Notes #

Combining these steps will eliminate the crashes: you're canceling stale requests, ensuring data only updates for the active tab, and adding safety guards to your table view code. This makes your app handle fast tab switches smoothly without unexpected errors.

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