UICollectionView因返回无效Header触发崩溃的问题求解

报错含义 #

你遇到的崩溃是UIKit抛出的内部一致性异常，完整报错信息如下：

*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 
'the view returned from -collectionView:viewForSupplementaryElementOfKind:atIndexPath: was not 
retrieved by calling -dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath: 
for element kind 'UICollectionElementKindSectionHeader' at index path <NSIndexPath: 0x8aeb905cf5be0ed2> 
{length = 2, path = 0 - 0}; supplementary view: 
<UICollectionReusableView: 0x7f9236dc4ff0; frame = (0 0; 0 0); layer = <CALayer: 0x600001018620>>'

异常核心提示非常明确：collectionView:viewForSupplementaryElementOfKind:atIndexPath:方法返回的视图，没有通过系统规定的复用方法获取。

问题成因 #

• UICollectionView的补充视图（Section Header、Footer都属于这类）有强制的复用机制要求，所有返回的视图必须通过dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath:方法从复用队列中获取，你代码中不符合section==2条件的分支直接return UICollectionReusableView()是手动初始化的视图，没有走系统复用流程，直接违反了UIKit的规则，所以触发崩溃。
• 该代理方法调用早于Cell的代理方法是正常逻辑：UICollectionView计算布局时会先处理Section的Header/Footer，再加载Section内的Cell，所以Header相关代理的调用优先级更高。
• 你只有section=2的Header分支返回了自定义视图，其余所有section的Header触发代理时都会走到手动初始化视图的默认分支，只要你的collectionView存在section!=2的Header加载需求，就会触发崩溃。

解决方案 #

方案1：规范复用逻辑（所有分支都走复用队列） #

1. 提前给UICollectionView注册需要用到的所有补充视图类型：

// 注册自定义Header
collectionView.register(SomeCustomHeader.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: "CustomHeader")
// 注册通用空白Header，用于不需要自定义Header的section
collectionView.register(UICollectionReusableView.self, forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader, withReuseIdentifier: "EmptyHeader")

2. 修改代理方法，所有返回的视图都从复用队列获取：

func collectionView(_ collectionView: UICollectionView, viewForSupplementaryElementOfKind kind: String, at indexPath: IndexPath) -> UICollectionReusableView {
    guard kind == UICollectionView.elementKindSectionHeader else {
        // 如果有Footer需求同理处理，没有的话返回空白复用视图
        return collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: "EmptyHeader", for: indexPath)
    }
    if indexPath.section == 2 {
        let customHeader = collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: "CustomHeader", for: indexPath) as! SomeCustomHeader
        // 自定义Header的配置逻辑写在这里
        return customHeader
    }
    // 其他section返回空白复用Header
    return collectionView.dequeueReusableSupplementaryView(ofKind: kind, withReuseIdentifier: "EmptyHeader", for: indexPath)
}

方案2：优化布局，避免不必要的Header加载 #

如果除了section=2之外，其他section根本不需要显示Header，直接在布局代理中将对应section的Header高度设为0，系统就不会触发viewForSupplementaryElementOfKind的调用，性能更优：

func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForHeaderInSection section: Int) -> CGSize {
    return section == 2 ? CGSize(width: collectionView.bounds.width, height: 你需要的Header高度) : .zero
}

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