在UICollectionViewCell中居中放置UIImageView出现约束报错如何解决

问题原因 #

• 代码创建的视图默认开启translatesAutoresizingMaskIntoConstraints，会自动生成和你手动添加的约束冲突的规则，也会触发约束层级校验失败，使用纯代码自动布局必须手动关闭这个配置。
• 最初版本代码存在两处低级错误：一是将imageView直接添加到cell本体而非contentView上，二是写centerX约束时错误将父视图的参照属性写为了centerY，同时把跨视图的约束添加到了imageView本身，不符合约束添加的层级规则。
• 修改后的代码已经修复了上述问题，但还是漏了禁用Autoresizing转约束的配置，另外没有在cell的初始化方法中调用setupCell()，如果外部没有主动调用这个方法，约束不会被添加，调用时机不对也会触发层级错误。
• 多次调用setupCell()会重复添加imageView到contentView，导致冗余视图和重复约束。

修复后完整代码 #

import Foundation
import UIKit

class MenuCell: UICollectionViewCell{
    let image:UIImageView = {
        let i = UIImageView()
        i.image = UIImage(named: "mainMenu")
        i.contentMode = .scaleAspectFit
        // 核心修复：禁用自动约束转换
        i.translatesAutoresizingMaskIntoConstraints = false
        return i
    }()
    
    override init(frame: CGRect) {
        super.init(frame: frame)
        // 初始化时直接调用配置，避免外部漏调用
        setupCell()
    }
    
    required init?(coder: NSCoder) {
        fatalError()
    }
    
    private func setupCell(){
        contentView.addSubview(image)
        NSLayoutConstraint.activate([
            image.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            image.centerXAnchor.constraint(equalTo: contentView.centerXAnchor)
            // 可选：如果需要固定图片尺寸，可额外添加宽高约束
            // image.widthAnchor.constraint(equalToConstant: 40),
            // image.heightAnchor.constraint(equalToConstant: 40)
        ])
    }
}

如果你的图片尺寸是动态的，不需要额外添加宽高约束，UIImageView会根据图片内容自动计算固有尺寸，自动布局可以正常完成居中效果。

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