UICollectionView单元格复用后下载进度显示错位问题求助

这个问题本质上是单元格复用机制和「模型直接持有UI组件」的设计冲突导致的——当cell被复用时，你的NewsFeedDownload模型还握着旧cell的引用，进度更新自然会“跑”到错误的单元格上。下面是具体的修复方案，完全贴合UICollectionView的设计逻辑：

1. 先重构你的数据模型：去掉UI组件引用 #

模型层只负责存储数据，绝对不能持有cell、progressBar这类视图对象，这是MVC分层的核心原则。修改后的模型应该长这样：

class NewsFeedDownload {
    let uniqueId: String // 每个下载任务的唯一标识，用来匹配对应的cell
    var progress: Float = 0.0 // 0~1的进度值
    var isDownloading: Bool = false // 当前是否正在下载
    // 其他业务属性：比如下载链接、文件名称等
    
    init(uniqueId: String) {
        self.uniqueId = uniqueId
    }
}

2. 让Cell自己订阅进度变化，而非被模型绑定 #

在自定义的UICollectionViewCell中，实现配置方法和复用清理逻辑，让cell只响应自己绑定的下载任务的进度更新：

class NewsFeedCollectionViewCell: UICollectionViewCell {
    @IBOutlet weak var progressBar: CircularProgressBar!
    @IBOutlet weak var progressContainerView: UIView!
    
    private var currentDownloadModel: NewsFeedDownload?
    private var progressObserver: NSObjectProtocol? // 用来保存通知监听的引用
    
    // 复用前必须重置状态，这是解决bug的关键！
    override func prepareForReuse() {
        super.prepareForReuse()
        
        // 重置UI
        progressBar.progress = 0.0
        progressContainerView.isHidden = true
        
        // 取消之前的进度监听
        if let observer = progressObserver {
            NotificationCenter.default.removeObserver(observer)
            progressObserver = nil
        }
        
        currentDownloadModel = nil
    }
    
    // 给cell配置对应的下载模型
    func configure(with downloadModel: NewsFeedDownload) {
        currentDownloadModel = downloadModel
        
        // 初始化显示状态
        progressBar.progress = downloadModel.progress
        progressContainerView.isHidden = !downloadModel.isDownloading
        
        // 监听进度更新通知，只处理和当前模型匹配的更新
        progressObserver = NotificationCenter.default.addObserver(
            forName: NSNotification.Name("DownloadProgressUpdated"),
            object: nil,
            queue: .main
        ) { [weak self] notification in
            guard let self = self,
                  let updatedModel = notification.object as? NewsFeedDownload,
                  updatedModel.uniqueId == self.currentDownloadModel?.uniqueId else {
                return
            }
            
            // 更新UI
            self.progressBar.progress = updatedModel.progress
            self.progressContainerView.isHidden = !updatedModel.isDownloading
        }
    }
}

3. 下载任务中更新模型，通过通知触发UI刷新 #

在你的下载逻辑里，不要直接操作cell，而是更新对应NewsFeedDownload模型的进度，再通过通知中心告诉所有订阅的cell：

func updateDownloadProgress(for model: NewsFeedDownload, newProgress: Float) {
    DispatchQueue.main.async {
        model.progress = newProgress
        model.isDownloading = newProgress < 1.0 // 进度小于1说明还在下载
        
        // 发送进度更新通知
        NotificationCenter.default.post(
            name: NSNotification.Name("DownloadProgressUpdated"),
            object: model
        )
    }
}

4. 额外优化：用Combine替代通知（Swift项目） #

如果你的项目使用Swift，可以用Combine框架实现更优雅的响应式更新，避免通知中心的全局广播：

// 修改模型，添加@Published属性
class NewsFeedDownload: ObservableObject {
    let uniqueId: String
    @Published var progress: Float = 0.0
    @Published var isDownloading: Bool = false
    
    init(uniqueId: String) {
        self.uniqueId = uniqueId
    }
}

// Cell中使用Combine订阅
class NewsFeedCollectionViewCell: UICollectionViewCell {
    @IBOutlet weak var progressBar: CircularProgressBar!
    @IBOutlet weak var progressContainerView: UIView!
    
    private var currentDownloadModel: NewsFeedDownload?
    private var cancellables = Set<AnyCancellable>()
    
    override func prepareForReuse() {
        super.prepareForReuse()
        progressBar.progress = 0.0
        progressContainerView.isHidden = true
        cancellables.removeAll() // 取消所有订阅
        currentDownloadModel = nil
    }
    
    func configure(with downloadModel: NewsFeedDownload) {
        currentDownloadModel = downloadModel
        
        // 初始状态
        progressBar.progress = downloadModel.progress
        progressContainerView.isHidden = !downloadModel.isDownloading
        
        // 订阅进度变化
        downloadModel.$progress
            .receive(on: DispatchQueue.main)
            .sink { [weak self] progress in
                self?.progressBar.progress = progress
            }
            .store(in: &cancellables)
        
        // 订阅下载状态变化
        downloadModel.$isDownloading
            .receive(on: DispatchQueue.main)
            .sink { [weak self] isDownloading in
                self?.progressContainerView.isHidden = !isDownloading
            }
            .store(in: &cancellables)
    }
}

关键注意点 #

• 每个下载任务的uniqueId必须唯一，这是匹配cell和模型的核心标识；
• 永远不要让模型持有UI组件，遵循“数据驱动视图”的原则；
• prepareForReuse()方法一定要做好状态清理，否则旧的进度监听会干扰新cell的显示。

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