UICollectionViewCell调用reloadData后出现约束冲突问题求助

问题场景 #

自定义的UICollectionViewCell首次渲染无异常，但调用collectionView.reloadData()方法后，控制台出现约束错误。

自定义Cell代码 #

class CategoryCell: UICollectionViewCell {
  private lazy var nameLabel: UILabel = {
    let label = PaddingLabel()
    label.numberOfLines = 1
    label.adjustsFontForContentSizeCategory = true
    label.font = UIFont.boldSystemFont(ofSize: UIFont.preferredFont(forTextStyle: .subheadline).pointSize)
    label.textAlignment = .center
    let widthConstant = floor((UIScreen.main.bounds.size.width) / 3)
    label.widthAnchor.constraint(equalToConstant: widthConstant).isActive = true
    return label
  }()

  private lazy var bottomLine = UIView()

  override init(frame: CGRect) {
    super.init(frame: frame)
    configureViews()
  }

  required init?(coder: NSCoder) {
    super.init(coder: coder)
    configureViews()
  }

  override func prepareForReuse() {
    super.prepareForReuse()
    nameLabel.text = nil
  }
}

private extension CategoryCell {
  func configureViews() {
    contentView.addSameSizeConstrained(subView: nameLabel)
    contentView.addSubview(bottomLine)

    bottomLine.translatesAutoresizingMaskIntoConstraints = false

    NSLayoutConstraint.activate([
      bottomLine.leadingAnchor.constraint(equalTo: contentView.leadingAnchor),
      bottomLine.topAnchor.constraint(equalTo: contentView.bottomAnchor),
      bottomLine.trailingAnchor.constraint(equalTo: contentView.trailingAnchor),
      bottomLine.heightAnchor.constraint(equalToConstant: AppLayoutGuidance.spacingHalf / 4),
    ])
  }
}

约束错误日志 #

"<NSLayoutConstraint:0x600000d01090 App.PaddingLabel:0x13d494320.width == 130   (active)>",
"<NSLayoutConstraint:0x600000d010e0 H:|-(0)-[App.PaddingLabel:0x13d494320]   (active, names: '|':UIView:0x13d467360 )>",
"<NSLayoutConstraint:0x600000d01130 App.PaddingLabel:0x13d494320.trailing == UIView:0x13d467360.trailing   (active)>",
"<NSLayoutConstraint:0x600000d02850 'UIView-Encapsulated-Layout-Width' UIView:0x13d467360.width == 0   (active)>"

原因分析 #

1. 约束重复冲突：在nameLabel的懒加载闭包中，你主动激活了一个固定宽度约束；同时configureViews()里调用的addSameSizeConstrained(subView:)方法，会给label添加上下左右与contentView完全相等的约束（包括水平方向的宽度匹配）。这就导致label的水平方向同时存在两个互斥的约束：固定宽度130，以及和contentView宽度相等。
2. 复用触发冲突暴露：首次渲染时，cell的contentView有实际布局宽度，系统会暂时忽略冲突；但调用reloadData()时，cell被复用，contentView可能被临时设置为宽度0（日志中的UIView-Encapsulated-Layout-Width约束），此时固定宽度130和宽度0的矛盾直接爆发，约束冲突就被控制台捕获。

解决方案 #

方案一：移除重复的固定宽度约束（推荐） #

删除nameLabel懒加载中的固定宽度约束代码：

// 移除这一行
label.widthAnchor.constraint(equalToConstant: widthConstant).isActive = true

改为通过UICollectionView的布局来控制cell宽度，比如使用UICollectionViewFlowLayout时设置itemSize：

let layout = UICollectionViewFlowLayout()
let itemWidth = floor(UIScreen.main.bounds.width / 3)
layout.itemSize = CGSize(width: itemWidth, height: 44) // 根据实际需求设置高度
collectionView.collectionViewLayout = layout

这样label会自动适应contentView的宽度，不会产生约束冲突。

方案二：调整约束优先级（保留固定宽度需求时） #

如果必须保留label的固定宽度，需要降低固定宽度约束的优先级，避免和contentView的宽度约束冲突：

// 在nameLabel懒加载中修改约束优先级
let widthConstraint = label.widthAnchor.constraint(equalToConstant: widthConstant)
widthConstraint.priority = .defaultHigh // 低于required优先级
widthConstraint.isActive = true

或者，不要调用addSameSizeConstrained(subView:)，改为手动添加垂直方向的约束，只保留水平方向的固定宽度：

// 替换configureViews()中的addSameSizeConstrained调用
contentView.addSubview(nameLabel)
nameLabel.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    nameLabel.centerXAnchor.constraint(equalTo: contentView.centerXAnchor),
    nameLabel.topAnchor.constraint(equalTo: contentView.topAnchor),
    nameLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor),
    // 保留固定宽度约束
])

内容的提问来源于stack exchange，提问作者Ogün Birinci