UITableView自定义Cell高亮状态头像显示默认图问题排查

• 系统默认高亮逻辑触发显示异常：当selectionStyle设为.default时，UIKit在Cell进入高亮状态时，会自动同步所有子视图的highlighted属性为true。对于没有单独配置highlightedImage的UIImageView，部分iOS版本的高亮绘制流程会临时重置图片视图的显示缓冲，容易出现图片被清空的异常表现。
• 现有代码的逻辑缺陷放大了问题：
  • 每次调用configCell时，无论Cell上的图片是否已经加载完成，都会无条件执行cell.avatarImageView.image = .defaultImage。当触摸触发Cell高亮时，部分场景下UITableView会重新触发cellForRowAt代理方法，直接走到占位图赋值逻辑，把已加载的头像覆盖回占位图。
  • 仅靠cell.tag匹配回调校验的逻辑可靠性不足，tag值属于视图的全局通用属性，容易和其他逻辑产生冲突，且无法严格匹配Cell和对应的加载请求。
  • 没有处理Cell复用的资源重置逻辑，未完成的网络请求会在回调时错误给复用到其他位置的Cell赋值。

1. 修正头像视图的高亮行为 #

在自定义TableViewCell中，明确关闭头像视图跟随高亮状态自动切换图片的默认逻辑，同时重写高亮、选中方法，避免在状态切换时误修改头像图片：

• 初始化时为avatarImageView配置：avatarImageView.highlightedImage = nil、avatarImageView.tintColor = .clear，避免被系统高亮态的tintColor影响显示。
• 重写setHighlighted(_:animated:)和setSelected(_:animated:)方法时，只调用父类的默认实现，不额外修改avatarImageView的image值。

2. 优化Cell配置逻辑，避免无意义的图片覆盖 #

• 在自定义Cell中新增currentAvatarURL属性，记录当前Cell正在展示的头像地址，只有当传入的URL和当前记录不一致时，才重置占位图、发起新的网络请求，避免重复覆盖已加载完成的图片。
• 网络请求回调的校验逻辑中，除了匹配Cell位置，还要校验回调对应的URL和Cell当前记录的URL是否一致，防止旧请求给新展示的Cell赋错值。
• 持有当前执行的网络请求实例，在Cell复用时主动取消未完成的请求，避免无效回调。

3. 补充Cell复用的防护逻辑 #

重写自定义Cell的prepareForReuse方法，在Cell被复用前完成状态重置：

• 取消所有未完成的头像下载请求
• 清空之前记录的头像URL
• 将avatarImageView重置为默认占位图

class AvatarTableViewCell: UITableViewCell {
    // 头像视图
    let avatarImageView = UIImageView()
    // 记录当前Cell展示的头像URL
    private var currentAvatarURL: URL?
    // 持有当前下载任务，复用时可取消
    private var currentDownloadTask: URLSessionDataTask?

    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        // 配置头像视图，关闭高亮态图片切换
        avatarImageView.highlightedImage = nil
        avatarImageView.tintColor = .clear
        contentView.addSubview(avatarImageView)
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    // 重写高亮方法，不修改头像图片
    override func setHighlighted(_ highlighted: Bool, animated: Bool) {
        super.setHighlighted(highlighted, animated: animated)
    }

    // 重写选中方法，不修改头像图片
    override func setSelected(_ selected: Bool, animated: Bool) {
        super.setSelected(selected, animated: animated)
    }

    // 复用前重置状态
    override func prepareForReuse() {
        super.prepareForReuse()
        currentDownloadTask?.cancel()
        currentDownloadTask = nil
        currentAvatarURL = nil
        avatarImageView.image = .defaultImage
    }

    // 对外提供的头像配置方法
    func configureAvatar(urlString: String) {
        guard let url = URL(string: urlString) else {
            avatarImageView.image = .defaultImage
            return
        }
        // 已加载过相同URL的图片则直接返回
        guard url != currentAvatarURL else { return }
        // 更新当前记录的URL
        currentAvatarURL = url
        // 设置占位图
        avatarImageView.image = .defaultImage
        // 发起下载请求
        currentDownloadTask = URLSession.shared.dataTask(with: url) { [weak self] data, _, error in
            guard let self = self,
                  let data = data,
                  error == nil,
                  // 回调时校验URL匹配
                  url == self.currentAvatarURL else {
                return
            }
            DispatchQueue.main.async {
                self.avatarImageView.image = UIImage(data: data)
            }
        }
        currentDownloadTask?.resume()
    }
}

对应代理方法的调整：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    guard let cell = tableView.dequeueReusableCell(withIdentifier: "TableViewCell", for: indexPath) as? AvatarTableViewCell else {
        fatalError("Can't find cell")
    }
    cell.selectionStyle = .default
    let avatarURLString = dataSource[indexPath.row].avatarURLString
    cell.configureAvatar(urlString: avatarURLString)
    return cell
}

• 不再依赖cell.tag做请求回调的位置校验，避免tag值和其他视图逻辑冲突。
• 不要在每次configCell调用时无条件覆盖已加载完成的图片，只有URL不匹配、Cell复用时才需要设置占位图。
• 如果需要更完善的图片加载能力，可以在逻辑中加入内存缓存、磁盘缓存的实现，避免重复发起网络请求。

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