如何避免UICollectionView动态调整单元格时section header上滑消失？

我之前做类似的图片流布局时也踩过这个坑，willDisplay里触发批量更新确实容易打乱header的布局逻辑，尤其是FlowLayout下的悬停header。给你几个实际可行的解决思路：

1. 优先提前计算图片尺寸，避免在willDisplay中动态调整高度 #

这是从根源上解决问题的方案：

• 不要等到cell即将显示才加载图片并获取尺寸，而是在数据源准备阶段（比如接口请求完成后），用ImageIO框架异步获取图片的宽高信息（不用加载整张图片，性能开销很小）。
• 把图片尺寸存在你的数据模型里，cell初始化时直接根据这个尺寸设置图片视图的高度约束，这样cell的高度一开始就是正确的，willDisplay里只需要加载图片内容，不需要调整布局。
• 代码示例（获取图片尺寸）：

func getImageSize(from url: URL, completion: @escaping (CGSize?) -> Void) {
    DispatchQueue.global().async {
        guard let source = CGImageSourceCreateWithURL(url as CFURL, nil) else {
            completion(nil)
            return
        }
        let properties = CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any]
        let width = properties?[kCGImagePropertyPixelWidth] as? CGFloat
        let height = properties?[kCGImagePropertyPixelHeight] as? CGFloat
        DispatchQueue.main.async {
            completion(width.flatMap { w in height.map { h in CGSize(width: w, height: h) } })
        }
    }
}

2. 用layoutIfNeeded替代performBatchUpdates处理图片高度变化 #

如果实在没法提前计算尺寸，那可以放弃在图片加载时用performBatchUpdates，转而直接更新约束并触发局部布局：

• 图片加载完成后，直接修改cell内图片视图的高度约束常量，然后调用collectionView.layoutIfNeeded()（注意要放在UIView动画块里保留动画效果）：

// 图片加载完成后在cell内更新约束
imageViewHeightConstraint.constant = newImageHeight
UIView.animate(withDuration: 0.3) {
    self.collectionView.layoutIfNeeded()
}

• 这种方式只会更新当前cell的布局，不会触发整个collectionView的批量刷新，也就不会影响section header的位置。而其他场景（比如标签高度增加）的展开动画，依然可以用performBatchUpdates来实现，两者互不干扰。

3. 升级到UICollectionViewCompositionalLayout（iOS13+） #

如果你项目支持iOS13及以上，强烈建议切换到CompositionalLayout：

• 它的布局计算逻辑比传统FlowLayout更稳定，对supplementary view（section header）的位置管理更可靠，即使cell高度动态变化，也不会出现header突然消失的问题。
• 你可以通过boundarySupplementaryItems配置section header，并设置其pinToVisibleBounds属性来实现悬停效果，配合批量更新的动画也会更流畅。

4. 手动保存并恢复Header位置（兜底方案） #

如果以上方案都没法用，那可以用这个hack式的方法，在批量更新前后记录并恢复header的位置：

• 在调用performBatchUpdates前，记录当前可见header的屏幕坐标；更新完成后，手动调整collectionView的contentOffset来恢复header的位置：

// 记录当前可见header的位置
let headerKind = UICollectionView.elementKindSectionHeader
let visibleHeaderPaths = collectionView.indexPathsForVisibleSupplementaryElements(ofKind: headerKind)
var headerScreenFrames: [IndexPath: CGRect] = [:]
for path in visibleHeaderPaths {
    if let header = collectionView.supplementaryView(forElementKind: headerKind, at: path) {
        headerScreenFrames[path] = header.convert(header.bounds, to: UIApplication.shared.keyWindow)
    }
}

// 执行批量更新
collectionView.performBatchUpdates({
    // 你的更新逻辑：比如刷新cell高度约束
}) { [weak self] _ in
    guard let self = self else { return }
    // 恢复header位置
    for (path, targetFrame) in headerScreenFrames {
        if let header = self.collectionView.supplementaryView(forElementKind: headerKind, at: path) {
            let currentFrame = header.convert(header.bounds, to: UIApplication.shared.keyWindow)
            let offsetY = targetFrame.minY - currentFrame.minY
            self.collectionView.contentOffset = CGPoint(x: self.collectionView.contentOffset.x, y: self.collectionView.contentOffset.y + offsetY)
        }
    }
}

• 这个方法能临时解决header消失的问题，但要注意适配不同的屏幕方向和contentInset情况。

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