UICollectionView手动选中Item时出现约束警告问题排查

核心原因 #

这种仅在reloadData后手动选中Item才出现的约束冲突，本质是Cell复用机制下的布局状态残留 + 自动尺寸FlowLayout的布局时机冲突，具体分这几点：

1. 首次加载时，FlowLayout会一次性完成所有Cell的尺寸计算，此时Cell的布局约束处于稳定状态；但reloadData后，Cell被复用，选中操作会触发系统对Cell的二次布局调整（比如高亮状态的UI更新、尺寸重计算），这时候自定义约束和系统自动生成的尺寸约束（优先级990）出现优先级冲突。
2. 你给UIImageView设置了固定高度约束（默认优先级1000），而自动尺寸FlowLayout会根据Cell内容自动生成宽度/高度约束，当选中时系统强制调整Cell尺寸，两个高优先级约束互斥导致冲突。
3. 如果Cell在选中状态下有自定义UI修改（比如字体放大、图片尺寸变化），但未在prepareForReuse中重置状态，复用旧Cell的选中布局会和新的布局约束冲突。

具体解决步骤 #

• 调低自定义约束的优先级：把UIImageView的固定高度约束优先级从默认的1000调低到900，让FlowLayout自动生成的尺寸约束（优先级990）优先生效。比如在代码里设置：

  imageViewHeightConstraint.priority = UILayoutPriority(rawValue: 900)
  

• 在prepareForReuse中重置布局状态：清空Cell复用前的选中状态布局修改，避免残留约束干扰新布局：

  override func prepareForReuse() {
      super.prepareForReuse()
      // 重置UIImageView的约束状态，比如恢复默认尺寸
      imageViewHeightConstraint.constant = 80 // 你的默认高度
      // 重置Label的字体、颜色等选中状态修改
      titleLabel.font = UIFont.systemFont(ofSize: 14)
  }
  

• 用宽高比替代固定高度：如果UIImageView需要保持比例，给它添加宽高比约束（比如1:1），而不是固定高度，这样能适配Cell的自动宽度变化，避免尺寸冲突。
• 排查系统默认的选中布局干扰：如果不需要系统默认的高亮/选中效果，直接禁用：

  func collectionView(_ collectionView: UICollectionView, shouldHighlightItemAt indexPath: IndexPath) -> Bool {
      return false
  }
  

• 用Debug View Hierarchy定位冲突：打开Xcode的Debug View Hierarchy，选中冲突的Cell，查看Constraints面板里的红色冲突约束，明确是自定义约束还是系统约束，再针对性调整。

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