仅iPhone13 Pro下UICollectionViewFlowLayout布局Cell不居中缺列排查

核心原因分析 #

• 浮点精度溢出：iPhone13 Pro的逻辑分辨率为390pt，和其他机型的尺寸差异导致现有宽度计算逻辑得出的width带的小数位累积后，总布局宽度（所有cell宽度+列间距总和）超出了collectionView的实际可布局宽度，流布局判定当前行放不下最后一列，自动折行后就会出现缺列的视觉表现。
• iOS15 流布局默认配置变更：iOS15中UICollectionViewFlowLayout新增了sectionHeaderTopPadding属性，默认值非0，同时自动估算尺寸的优先级提升，如果开启了估算尺寸会干扰固定尺寸cell的布局计算。
• 布局时机错误导致宽度取错：如果宽度计算放在viewDidLoad等布局未完成的生命周期执行，拿到的是xib/storyboard的默认frame宽度，而非iPhone13 Pro的实际屏幕宽度，刚好触发总宽度溢出。
• ProMotion刷新率适配问题：120Hz高刷屏的布局刷新时机和普通屏幕存在差异，非实时计算的布局尺寸容易出现偏差。

排查方向 #

• 校验总布局宽度精度：打印当前计算出的单cell宽度、总布局宽度（单cell宽度列数 + 5(列数-1)）和collectionView的实际可布局宽度，确认总宽度是否超出。如果存在溢出，将宽度计算修改为向下取整，示例代码如下：

// 替换原有宽度计算逻辑，使用collectionView的实际可布局宽度计算
let numberOfColumn = CGFloat(configure.numberOfColumn)
let validWidth = collectionView.bounds.width - collectionView.contentInset.left - collectionView.contentInset.right
let totalSpacing = 5 * (numberOfColumn - 1)
let width = floor((validWidth - totalSpacing) / numberOfColumn)

• 检查流布局配置：确认minimumInteritemSpacing的设置值和你计算时用的5一致，禁用自动估算尺寸，将estimatedItemSize设置为CGSizeZero，同时手动配置sectionHeaderTopPadding = 0关闭iOS15默认的头部内边距。
• 调整宽度计算时机：不要缓存固定的cell宽度值，改为在UICollectionViewDelegateFlowLayout的sizeForItemAt代理方法中实时计算，或者在viewDidLayoutSubviews生命周期中重新计算布局并刷新。
• 校验可布局区域正确性：确认collectionView的contentInsetAdjustmentBehavior设置符合预期，不要忽略safe area对布局区域的影响，避免用父view的宽度代替collectionView自身的宽度做计算。

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