UICollectionView DecorationView延迟显示与布局异常问题求解

你当前实现的核心问题是DecorationView的生成逻辑绑定错误：

• 现有逻辑是遍历传入rect内所有cell的布局属性，为每个cell对应的indexPath生成DecorationView属性。如果移除row == 1的判断，section内有多少个进入预加载范围的cell，就会生成多少个DecorationView，必然出现单section重复挂载多个背景的问题。
• 保留decatts.indexPath.row == 1判断时，只有section内row=1的cell进入预加载区域才会触发背景创建，当section刚进入屏幕、仅第0行或header在可视范围内时，背景不会被加载，直接导致滚动时的显示延迟。

关于你观察到的rect参数异常：

layoutAttributesForElements(in:)传入的rect是系统计算的当前待渲染预加载区域，并非严格等于屏幕可视范围：

• origin.x为-844是系统预加载机制的正常表现，横向负偏移是为了提前计算屏幕外侧区域的布局，支撑滚动回弹、快速滚动的流畅性，和DecorationView的异常没有关联。
• 隔段出现rect高度翻倍是系统根据滚动速度、内容高度动态调整预加载窗口大小的正常行为，不属于布局错误。

DecorationView作为section背景，应该和section维度绑定，而非和section内的单个cell绑定，每个section只生成1个背景属性即可，具体实现步骤如下：

1. 首先在自定义FlowLayout初始化时注册DecorationView

// 自定义背景视图类，继承UICollectionReusableView即可，背景色、圆角等样式直接在这个类里配置
class SectionBackgroundDecorationView: UICollectionReusableView {
    override init(frame: CGRect) {
        super.init(frame: frame)
        self.backgroundColor = .systemGray6
        self.layer.cornerRadius = 12
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

// 自定义FlowLayout内的注册逻辑
override init() {
    super.init()
    self.register(SectionBackgroundDecorationView.self, forDecorationViewOfKind: "background")
}

required init?(coder: NSCoder) {
    super.init(coder: coder)
    self.register(SectionBackgroundDecorationView.self, forDecorationViewOfKind: "background")
}

2. 新增属性缓存，重写prepare()方法提前计算每个section的背景布局，避免滚动时重复计算

// 缓存每个section对应的背景布局属性
private var sectionBgAttributes: [Int: UICollectionViewLayoutAttributes] = [:]

override func prepare() {
    super.prepare()
    guard let collectionView = collectionView else { return }
    // 清空旧缓存，避免布局更新时属性错乱
    sectionBgAttributes.removeAll()
    
    let totalSection = collectionView.numberOfSections
    for section in 0..<totalSection {
        let itemCount = collectionView.numberOfItems(inSection: section)
        guard itemCount > 0 else { continue }
        // 取当前section第一个和最后一个item的布局，用来计算section的整体范围
        let firstItemPath = IndexPath(item: 0, section: section)
        let lastItemPath = IndexPath(item: itemCount - 1, section: section)
        guard let firstAttr = layoutAttributesForItem(at: firstItemPath),
              let lastAttr = layoutAttributesForItem(at: lastItemPath) else {
            continue
        }
        
        // 按需求计算背景frame，自动适配section实际高度，不需要写死高度倍数
        let bgFrame = CGRect(
            x: 0,
            y: firstAttr.frame.minY - 32, // 对应你原来的上偏移32
            width: collectionView.bounds.width,
            height: lastAttr.frame.maxY - firstAttr.frame.minY + 55 // 对应你原来的下偏移55
        )
        
        // 生成背景属性，indexPath绑定section维度
        let bgAttr = UICollectionViewLayoutAttributes(
            forDecorationViewOfKind: "background",
            with: IndexPath(item: 0, section: section)
        )
        bgAttr.frame = bgFrame
        bgAttr.zIndex = -1 // 置于所有cell下方
        sectionBgAttributes[section] = bgAttr
    }
}

3. 重写layoutAttributesForElements(in:)方法，只将和当前预加载rect相交的section背景加入返回属性列表

override func layoutAttributesForElements(in rect: CGRect) -> [UICollectionViewLayoutAttributes]? {
    guard let superAttributes = super.layoutAttributesForElements(in: rect) else { return nil }
    var allAttributes = Array(superAttributes)
    
    // 遍历缓存的section背景，只加入和当前渲染区域相交的背景，每个section最多1个
    for (_, bgAttr) in sectionBgAttributes {
        if bgAttr.frame.intersects(rect) {
            allAttributes.append(bgAttr)
        }
    }
    
    return allAttributes
}

4. 重写DecorationView属性查询方法，直接返回缓存的属性

override func layoutAttributesForDecorationView(ofKind elementKind: String, at indexPath: IndexPath) -> UICollectionViewLayoutAttributes? {
    guard elementKind == "background" else {
        return super.layoutAttributesForDecorationView(ofKind: elementKind, at: indexPath)
    }
    return sectionBgAttributes[indexPath.section]
}

• 每个section仅生成1个DecorationView，无重复渲染问题
• 只要section的任意部分进入预加载范围，背景就会同步加载，无滚动显示延迟
• 背景frame自动适配section的实际内容高度，位置、尺寸准确
• 不影响原有cell、sectionHeader、sectionFooter的布局逻辑

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