使用UICollectionViewCompositionalLayout实现自适应长单元格遇错误求解

问题根源 #

UICollectionView internal inconsistency: missing final attributes for cell 报错源于布局尺寸预估与单元格内部约束不匹配，同时未配置UILabel的自动换行属性，导致超长文本无法折行，触发布局计算异常。

具体修复步骤 #

1. 配置UILabel的自动换行属性 #

修改MyCollectionViewCell，开启文本换行并设置合理的换行模式：

class MyCollectionViewCell: UICollectionViewCell {
    
    let myLabel = UILabel()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        
        contentView.backgroundColor = .lightGray
        // 开启多行换行，按单词边界折行
        myLabel.numberOfLines = 0
        myLabel.lineBreakMode = .byWordWrapping
        myLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(myLabel)
        
        NSLayoutConstraint.activate([
            myLabel.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            myLabel.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            myLabel.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 8),
            myLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -8)
        ])
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
}

2. 调整CollectionView布局的尺寸设置 #

将固定高度改为预估高度，避免限制单元格的动态尺寸调整，同时优化宽度预估数值：

let layout = UICollectionViewCompositionalLayout { (sectionIndex, _) -> NSCollectionLayoutSection? in
    // 调整item的宽高为预估模式，提升布局计算稳定性
    let item = NSCollectionLayoutItem(layoutSize: .init(
        widthDimension: .estimated(100),
        heightDimension: .estimated(36))
    )
    let groupSize = NSCollectionLayoutSize(
        widthDimension: .fractionalWidth(1),
        heightDimension: .estimated(44)
    )
    let group = NSCollectionLayoutGroup.horizontal(
        layoutSize: groupSize,
        subitems: [item]
    )
    group.interItemSpacing = .fixed(8)
    
    let section = NSCollectionLayoutSection(group: group)
    section.interGroupSpacing = 8
    section.contentInsets = NSDirectionalEdgeInsets(top: 0, leading: 16, bottom: 16, trailing: 16)
    
    return section
}

3. 开启CollectionView自动尺寸计算 #

在viewDidLoad中添加自动尺寸配置，确保单元格能根据内容计算正确尺寸：

override func viewDidLoad() {
    super.viewDidLoad()
    
    view.addSubview(collectionView)
    // 开启自动尺寸计算
    collectionView.automaticDimension = true
    NSLayoutConstraint.activate([
        collectionView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        collectionView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        collectionView.topAnchor.constraint(equalTo: view.topAnchor),
        collectionView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
    collectionView.dataSource = self
}

修复原理 #

• Label配置：numberOfLines=0允许文本无限换行，byWordWrapping保证折行逻辑符合阅读习惯；
• 布局调整：使用estimated尺寸替代固定值，让UICollectionView能根据单元格内部约束动态计算最终尺寸，避免尺寸冲突引发的内部报错；
• 自动尺寸开关：collectionView.automaticDimension = true配合布局的预估设置，确保单元格尺寸计算精准。

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