在UICollectionViewCell中使用UIButton.Configuration致旋转时图文布局错乱

问题场景 #

在UICollectionViewCell内使用UIButton.Configuration配置按钮的标题与图片时，旋转设备会引发按钮的图片、标题位置错乱：初始状态显示正常，旋转一次后布局异常，切回原方向问题仍无法恢复。视图检查器无法定位问题根源，使用旧版setTitle:/setImage:API则无此问题，通过设置autoresizingMask的解决方式稳定性不足。

解决方案 #

1. 在prepareForReuse中重置按钮配置

UICollectionViewCell的复用机制可能导致旋转时残留旧的配置状态，在prepareForReuse中重新初始化配置，确保每次复用或布局更新时按钮使用全新的配置：

override func prepareForReuse() {
    super.prepareForReuse()
    
    var buttonConfig = UIButton.Configuration.filled()
    buttonConfig.title = "目标标题"
    buttonConfig.image = UIImage(systemName: "heart.fill")
    buttonConfig.imagePlacement = .leading
    buttonConfig.imagePadding = 8
    
    yourButton.configuration = buttonConfig
}

2. 在layoutSubviews中强制刷新配置

旋转设备会触发cell的layoutSubviews方法，在这里重新赋值当前配置，强制按钮重新计算布局：

override func layoutSubviews() {
    super.layoutSubviews()
    
    guard let currentConfig = yourButton.configuration else { return }
    // 重新赋值配置，触发按钮内部布局更新
    yourButton.configuration = currentConfig
}

3. 为按钮添加明确的布局约束

如果上述方法无效，给按钮添加固定的Auto Layout约束，避免布局系统自动调整导致的错乱：

// 在cell初始化方法中添加约束
yourButton.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    yourButton.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 12),
    yourButton.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 12),
    yourButton.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -12),
    yourButton.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -12)
])

问题原因 #

旧版setTitle:/setImage:API直接操作按钮的子视图，布局系统对这类子视图的管理逻辑成熟；而UIButton.Configuration基于苹果的新配置系统，在UICollectionViewCell复用、设备旋转触发布局更新的场景下，内部的布局触发逻辑存在兼容性问题，导致配置的布局属性未被正确应用。

内容的提问来源于stack exchange，提问作者Claus Jørgensen