Swift开发中UITableView偶发加载空白、图片不显示的原因及刷新方案问询
问题根因与可落地的修复方案
一、图片无法加载的问题排查与修复
核心原因有两个,按出现概率从高到低排序:
- ATS明文协议拦截
iOS 9之后系统默认禁止App发起未加密的http网络请求,你现在用的图片地址是http://localhost:3000/xxx,属于明文请求,哪怕在设备浏览器里直接访问能正常打开,App内的网络请求(包括Kingfisher发起的图片请求)都会被系统直接拦截,根本发不出网络包。
修复方式:打开项目的Info.plist,添加本地网络例外配置(不要全局关闭ATS,否则App Store审核会被拒):<key>NSAppTransportSecurity</key> <dict> <key>NSAllowsLocalNetworking</key> <true/> </dict> - cell赋值逻辑不合理导致的图片加载失效
cellForRowAt方法本身就在主线程执行,你额外套的DispatchQueue.main.async异步块会造成竞态:当用户快速滚动列表时,cell已经被复用到其他行、甚至滚出屏幕了,之前排队的异步块才执行图片赋值,要么出现图片错配,要么根本无法更新到正确的imageView上。
另外拼接图片URL时没有做特殊字符编码,如果数据库存的图片文件名包含空格、中文等特殊字符,拼出来的URL是不合法的,Kingfisher自然加载失败。
修复后的cellForRowAt核心逻辑参考:func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { guard let cell = tableView.dequeueReusableCell(withIdentifier: "mCellBike", for: indexPath) as? UITableViewCell, let imageView = cell.contentView.viewWithTag(1) as? UIImageView, let label = cell.contentView.viewWithTag(2) as? UILabel else { return UITableViewCell() } // 先清空复用时的旧内容,避免错配 imageView.image = UIImage(named: "占位图") label.text = bikes[indexPath.row].model // 合法拼接图片URL guard let imagePath = bikes[indexPath.row].image.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed), let url = URL(string: "http://localhost:3000/\(imagePath)") else { return cell } // Kingfisher本身自带后台加载、cell复用时的请求取消逻辑,不需要额外套GCD imageView.kf.setImage(with: url, placeholder: UIImage(named: "占位图")) return cell }
二、数据延迟导致UITableView空白的问题修复
核心原因是数据请求完成后没有主动刷新UITableView:
你在viewDidLoad里发起的URLSession.dataTask回调是在后台队列执行的,你在回调里把bikes数组从空填充成真实数据后,缺少两个关键操作:
- 切回主线程(所有UI更新必须在主线程执行)
- 调用
tableView.reloadData()告知UITableView数据源已经更新,重新加载所有行
因为没有这两步,UITableView从初始化到现在一直用的是空的bikes数组(初始计数0),自然一直显示空白,直到用户手动滚动触发页面重绘才可能看到数据。
另外需要注意:如果你的UITableView是通过Storyboard创建的,需要在Storyboard面板里把TableView的dataSource和delegate连线到当前视图控制器,否则就算实现了协议方法,UITableView也不会触发相关回调。
修复后的网络请求核心逻辑参考:
override func viewDidLoad() { super.viewDidLoad() guard let url = URL(string: "http://localhost:3000/bikes") else { return } URLSession.shared.dataTask(with: url) { [weak self] data, response, error in guard let self = self, let data = data else { return } do { let json = try JSONSerialization.jsonObject(with: data, options: []) as? [[String:Any]] ?? [] self.bikes.removeAll() for item in json { // 安全解析JSON,避免强制解包崩溃 let id = item["bike_id"] as? Int ?? 0 let model = item["model"] as? String ?? "" let type = item["type"] as? String ?? "" let price = item["price"] as? String ?? "" let image = item["image"] as? String ?? "" self.bikes.append(Bike(id: id, model: model, type: type, price: price, image: image)) } // 切回主线程刷新UI DispatchQueue.main.async { self.tableView.reloadData() } } catch { print("JSON解析错误:\(error)") } }.resume() }
内容的提问来源于stack exchange,提问作者Fares Ben Slama
相关产品推荐
相关产品推荐

