Swift UICollectionView添加Header报错：未通过正确方法获取复用视图

Hey there, let's break down why you're running into this UICollectionView header error and fix it step by step!

First, let's recap the error you're seeing:

从-collectionView:viewForSupplementaryElementOfKind:atIndexPath（UICollectionElementKindSectionHeader, {length = 2, path = 0 - 0}）返回的视图未通过调用-dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath:获取，或视图为nil (>) (null)

What's causing this? #

Looking at your code, there are a few spots where you're violating a core UICollectionView rule: all reusable supplementary views (including headers) must be fetched via dequeueReusableSupplementaryView—you can't manually instantiate and return a new UICollectionReusableView() directly.

Specifically, these parts are triggering the issue:

• When member == nil, you return a brand new UICollectionReusableView()
• In the non-Section.header case, you manually create a UICollectionReusableView for the separator line
• The default branch also returns a new UICollectionReusableView()

How to fix it #

Follow these steps to get your headers working correctly:

1. Register a generic reusable view
   First, add a registration for a basic reusable view to handle the separator line and empty states. Add this alongside your existing ProfileHeaderView registration:

// In viewDidLoad or wherever you register your collection views
collectionView?.register(UICollectionReusableView.self, forSupplementaryViewOfKind: UICollectionElementKindSectionHeader, withReuseIdentifier: Identifier.genericHeader)

(Note: Update your Identifier enum to include a genericHeader case, or use a raw string like "GenericHeader" if you're not using an enum.)

2. Rewrite the viewForSupplementaryElementOfKind method
   Update your method to ensure every returned view comes from the dequeue method, and fix the separator view reuse issue:

override func collectionView(_ collectionView: UICollectionView, viewForSupplementaryElementOfKind kind: String, at indexPath: IndexPath) -> UICollectionReusableView {
    guard let member = member else {
        // Fetch from dequeue instead of creating a new view
        return collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: Identifier.genericHeader, for: indexPath)
    }
    
    switch kind {
    case UICollectionElementKindSectionHeader:
        if indexPath.section == Section.header {
            let profileHeaderView = collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: Identifier.header, for: indexPath) as! ProfileHeaderView
            profileHeaderView.config(...)
            return profileHeaderView
        } else {
            // Get the reusable view from the queue
            let reusableView = collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: Identifier.genericHeader, for: indexPath)
            
            // Remove old subviews first to avoid duplicate separator lines on reuse
            reusableView.subviews.forEach { $0.removeFromSuperview() }
            
            // Add and configure the separator line
            let seperatorLine = UIView.seperatorLine()
            seperatorLine.translatesAutoresizingMaskIntoConstraints = false
            reusableView.addSubview(seperatorLine)
            
            NSLayoutConstraint.activate([
                seperatorLine.bottomAnchor.constraint(equalTo: reusableView.bottomAnchor),
                seperatorLine.leftAnchor.constraint(equalTo: reusableView.leftAnchor),
                seperatorLine.centerXAnchor.constraint(equalTo: reusableView.centerXAnchor)
            ])
            reusableView.backgroundColor = Color.white
            return reusableView
        }
    default:
        // Fetch from dequeue here too
        return collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: Identifier.genericHeader, for: indexPath)
    }
}

3. Key additional notes

• Always avoid adding subviews directly to reused views without cleaning up old ones—this causes duplicate UI elements as views are recycled.
• Double-check that Section.header maps to the correct section index where you want to display your ProfileHeaderView.
• Sticking to UICollectionView's reuse rules ensures proper memory management and avoids the error you encountered.

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