Storyboard中UICollectionView结合Diffable DataSource显示异常问题求助

核心问题分析 #

你遇到的两个问题本质是同一个原因：UICollectionView.CellRegistration是纯代码注册cell的方案，和Storyboard中已配置的自定义cell复用逻辑冲突，导致系统无法正确加载Storyboard里带Outlet的自定义cell，要么Outlet关联失败触发nil崩溃，要么加载了默认空cell。

分步解决步骤 #

1. 废弃CellRegistration，改用Storyboard复用标识符创建Diffable DataSource

你的cell是在Storyboard中配置的，不需要用代码注册，直接通过复用标识符从Storyboard加载cell即可。修改Diffable DataSource初始化代码如下：

// 示例数据模型（根据你的实际需求调整）
struct ListItem: Hashable {
    let id = UUID()
    let content: String
}

class YourViewController: UIViewController {
    @IBOutlet weak var collectionView: UICollectionView!
    
    private var dataSource: UICollectionViewDiffableDataSource<Int, ListItem>!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupDataSource()
        loadSampleData()
    }
    
    private func setupDataSource() {
        // 这里的复用标识符必须和Storyboard中自定义cell的identifier完全一致
        let cellReuseID = "CustomCollectionCell"
        
        dataSource = UICollectionViewDiffableDataSource(collectionView: collectionView) { [weak self] collectionView, indexPath, item in
            guard let cell = collectionView.dequeueReusableCell(withReuseIdentifier: cellReuseID, for: indexPath) as? CustomCollectionCell else {
                fatalError("无法获取自定义cell，请检查复用标识符和cell类设置")
            }
            // 此时Outlet已正确关联，可安全设置文本
            cell.contentLabel.text = item.content
            return cell
        }
    }
    
    private func loadSampleData() {
        let sampleItems = [
            ListItem(content: "第一条内容"),
            ListItem(content: "第二条内容"),
            ListItem(content: "第三条内容")
        ]
        var snapshot = NSDiffableDataSourceSnapshot<Int, ListItem>()
        snapshot.appendSections([0])
        snapshot.appendItems(sampleItems)
        dataSource.apply(snapshot, animatingDifferences: true)
    }
}

2. 检查Storyboard关键配置（必须完全匹配）

• 自定义Cell设置：
  1. 选中Storyboard里的CollectionViewCell，在Identity Inspector中将Class设置为你的自定义cell类（比如CustomCollectionCell），不能留空或选择系统默认类
  2. 在Attributes Inspector中设置Identifier为代码里使用的CustomCollectionCell（大小写、拼写完全一致）
• Outlet关联检查：
  打开自定义cell类，确认label的Outlet是从Storyboard拖拽关联的，左侧导航栏中cell类的Outlet图标为实心（不是空心，空心代表关联断开）
• CollectionView设置：
  确认CollectionView的DataSource和Delegate已关联到你的ViewController（右键CollectionView，将dataSource和delegate拖到ViewController上）

3. 删除手动注册cell的代码

之前尝试的手动注册代码（比如collectionView.register(CustomCollectionCell.self, forCellWithReuseIdentifier:...)）会覆盖Storyboard中的cell配置，必须删掉这行代码，让系统从Storyboard加载cell。

验证效果 #

完成以上修改后运行项目：

• 不会再出现Unexpectedly found nil崩溃
• CollectionView会正确显示每个自定义cell的label文本

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