iOS开发报错：UICollectionViewCell无复用标识，求解决方案

问题描述 #

报错信息：从-collectionView:cellForItemAtIndexPath:返回的cell没有复用标识——必须通过调用-dequeueReusableCellWithReuseIdentifier:forIndexPath:获取cell

场景：在UITableViewCell中内嵌UICollectionView，核心代码如下：

CollectionViewTableViewCell 核心代码 #

import UIKit

protocol CollectionViewTableViewCellDelegate: AnyObject {
    func collectionViewTableViewCellDidTapCell(_ cell: CollectionViewTableViewCell, viewModel: TitlePreviewViewModel)
}

class CollectionViewTableViewCell: UITableViewCell {

    static let identifier = "CollectionViewTableViewCellId"
    
    weak var delegate: CollectionViewTableViewCellDelegate?
    
    private var titles: [Title] = [Title]()
    
    private let collectionView: UICollectionView = {
        let layout = UICollectionViewFlowLayout()
        layout.itemSize = CGSize(width: 140, height: 200)
        layout.scrollDirection = .horizontal
        let collectionView = UICollectionView(frame: .zero, collectionViewLayout: layout)
        collectionView.register(TitleCollectionViewCell.self, forCellWithReuseIdentifier: TitleCollectionViewCell.identifier)
        return collectionView
    }()
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        
        contentView.addSubview(collectionView)
        
        collectionView.delegate = self
        collectionView.dataSource = self
    }
    
    required init?(coder: NSCoder) {
        fatalError()
    }
    
    override func layoutSubviews() {
        super.layoutSubviews()
        collectionView.frame = contentView.bounds
    }
    
    public func configure(with titles: [Title]) {
        self.titles = titles
        DispatchQueue.main.async { [weak self] in
            self?.collectionView.reloadData()
        }
    }
}

UICollectionView代理扩展代码 #

extension CollectionViewTableViewCell: UICollectionViewDelegate, UICollectionViewDataSource {
    
    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {

        guard let cell = collectionView.dequeueReusableCell(withReuseIdentifier: TitleCollectionViewCell.identifier, for: indexPath) as? TitleCollectionViewCell else {
            return UICollectionViewCell()
        }
        
        guard let model = titles[indexPath.row].poster_path else {
            return UICollectionViewCell()
        }
        
        cell.configure(with: model)
        
        return cell
    }
}

ViewController中UITableView复用代码 #

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell    {
    guard let cell = tableView.dequeueReusableCell(withIdentifier: CollectionViewTableViewCell.identifier, for: indexPath) as? CollectionViewTableViewCell else {
        return UITableViewCell()
    }
    cell.delegate = self
    // 其他配置代码
    return cell
}

疑问：根据报错信息，UITableView并没有-dequeueReusableCellWithReuseIdentifier这个方法，该如何解决？

解决方案 #

这个报错的核心问题不是UITableView的复用方法，而是你在UICollectionView的cellForItemAt方法里，存在返回无复用标识cell的情况：

1. 当titles[indexPath.row].poster_path为空时，你直接返回了全新的UICollectionViewCell()，这个cell没有注册复用标识，触发报错。
2. 当dequeueReusableCell失败时返回的空cell也存在同样问题。

具体修复步骤 #

1. 不要直接返回空的UICollectionViewCell()，始终返回通过复用池获取的cell，即使没有数据，也可以返回复用的cell并做空白状态处理。
2. 优化cellForItemAt的逻辑：

修改后的cellForItemAt代码：

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
    // 强制获取复用cell（如果注册正确，这里不会失败）
    let cell = collectionView.dequeueReusableCell(withReuseIdentifier: TitleCollectionViewCell.identifier, for: indexPath) as! TitleCollectionViewCell
    
    // 处理数据为空的情况，设置cell的空白状态
    if let model = titles[indexPath.row].poster_path {
        cell.configure(with: model)
    } else {
        // 示例：清空cell内容，可根据需求设置占位图或隐藏控件
        cell.resetToEmptyState()
    }
    
    return cell
}

补充说明 #

• UITableView的dequeueReusableCell(withIdentifier:for:)是正确的Swift写法，它对应OC的dequeueReusableCellWithReuseIdentifier:forIndexPath:，Swift对OC方法名做了语法优化，所以你的UITableView复用代码没有问题。
• 确保TitleCollectionViewCell已正确注册到UICollectionView（你的代码中已经完成这一步，无需修改）。

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