键盘弹出/收起时如何修复‘UICollectionViewFlowLayout未定义’问题？

错误信息 #

The behavior of the UICollectionViewFlowLayout is not defined because: the item height must be less than the height of the UICollectionView minus the section ...

问题核心 #

水平滚动的UICollectionView在键盘收起时，自身高度被压缩到小于item所需的最小高度，同时伴随contentSize异常变小，导致FlowLayout布局逻辑崩溃。之前通过代理动态修改item尺寸的思路无法解决本质问题，反而可能加剧布局混乱。

可行解决方案 #

• 给CollectionView添加最小高度约束
  直接限制CollectionView的高度下限，确保它永远不会小于能容纳item的最小高度（item高度+section上下内边距），从根源避免高度不足的问题：

  // 在视图初始化或布局更新阶段添加
  let minHeight = itemHeight + sectionInsets.top + sectionInsets.bottom
  collectionView.heightAnchor.constraint(greaterThanOrEqualToConstant: minHeight).isActive = true
  

• 键盘收起后强制同步刷新布局
  键盘收起的动画过程可能导致CollectionView的contentSize计算滞后，在键盘收起完成后同步刷新布局与数据：

  // 键盘收起通知的回调方法内
  @objc func keyboardWillHide(_ notification: Notification) {
      DispatchQueue.main.async {
          self.collectionView.collectionViewLayout.invalidateLayout()
          self.collectionView.reloadData()
      }
  }
  

• 固定item高度适配CollectionView
  水平滚动场景下，item高度应与CollectionView的可用高度绑定，代理方法直接返回匹配值，无需动态调整：

  func collectionView(_ collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> CGSize {
      let availableHeight = collectionView.bounds.height - sectionInsets.top - sectionInsets.bottom
      return CGSize(width: 80, height: availableHeight) // width根据业务需求调整
  }
  

• 排查并移除布局循环约束
  检查是否给CollectionView添加了依赖contentSize的约束（比如高度等于contentSize高度），这类约束会触发布局循环，进而导致contentSize异常，直接移除即可。

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