UIKit单元格中withObservationTracking无法检测@Observable模型属性变更

核心问题根源 #

UIKit复用单元格中withObservationTracking的使用未适配UIKit单元格生命周期：首次配置时未手动触发更新、监听路径未精准绑定当前单元格的model、复用残留的旧监听干扰，且@Observable的缓存变更未被正确追踪。

具体修复步骤与代码实现 #

1. 适配单元格生命周期，清理复用残留

在单元格prepareForReuse中清空旧监听、数据，避免复用错误关联旧model/viewModel：

class UIPhotoGridCell: UICollectionViewCell {
    static let reuseIdentifier = "UIPhotoGridCell"
    
    private var currentModel: PhotoModel?
    private var viewModel: LibraryViewModel?
    private var observationToken: ObservationToken?
    private let imageView = UIImageView()

    override func prepareForReuse() {
        super.prepareForReuse()
        observationToken = nil
        currentModel = nil
        viewModel = nil
        imageView.image = nil
    }
}

2. 修正监听逻辑，手动触发首次更新

withObservationTracking的onChange仅在属性变更后触发，首次配置需手动更新图片；同时明确监听当前model的id和对应图片，而非泛泛的ViewModel属性：

func configure(with model: PhotoModel, viewModel: LibraryViewModel) {
    self.currentModel = model
    self.viewModel = viewModel
    
    // 手动触发首次图片加载
    updateImage()
    
    // 绑定精准监听路径
    observationToken = withObservationTracking { [weak self] in
        _ = self?.currentModel?.id
        _ = self?.viewModel?.bestAvailableImage(for: model.id)
    } onChange: { [weak self] in
        // 确保UI更新在主线程
        DispatchQueue.main.async {
            self?.updateImage()
        }
    }
}

private func updateImage() {
    guard let model = currentModel, let viewModel = viewModel else { return }
    imageView.image = viewModel.bestAvailableImage(for: model.id)?.image
}

3. 确保ViewModel的缓存变更能被Observation捕获

如果bestAvailableImage基于缓存字典实现，需添加可观察的触发标记，让系统感知缓存更新：

@Observable
class LibraryViewModel {
    private var imageCache: [String: WeakImage] = [:]
    // 用版本号触发缓存变更的Observation
    private var cacheVersion = 0

    func bestAvailableImage(for photoId: String) -> WeakImage? {
        // 访问版本号，让监听追踪到缓存变化
        _ = cacheVersion
        return imageCache[photoId]
    }

    func updateImage(_ image: UIImage, for photoId: String) {
        imageCache[photoId] = WeakImage(image: image)
        // 更新版本号触发Observation
        cacheVersion += 1
    }
}

关键说明 #

• 单元格复用必须清理旧监听，否则会出现多个单元格监听同一旧model的情况
• 手动触发首次更新是因为withObservationTracking默认不会在首次追踪时执行回调
• 缓存字典内部变化无法被直接监听，通过cacheVersion这类可观察属性可以间接触发变更通知

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