修复UITableViewCell首次加载时约束不正确的问题

首次加载约束失效的核心原因是：你在cellForRowAt回调中调用setImageConstraints计算尺寸时，Cell尚未完成Auto Layout布局流程，此时self.photoView.frame的宽高是xib/代码中设置的初始值（多数场景下是未布局完成的错误值，甚至为0），基于错误frame计算出的宽高比例、约束常量自然不符合预期。
当Cell滚动出可视区域被回收、再次滚回屏幕时，Cell已经完成过至少一轮完整布局，photoView.frame为最终展示的正确尺寸，此时计算出的约束才会符合预期。

方案1：在Cell布局生命周期内更新约束，避免提前读取frame #

不要在cellForRowAt阶段直接读取未布局完成的frame计算约束，把图片原始尺寸透传给Cell，等Cell进入布局周期、尺寸确定后再计算约束常量：

1. 给自定义Cell新增属性存储必要参数，不要依赖外部调用时的临时计算：

class PhotoCell: UITableViewCell {
    @IBOutlet weak var photoView: UIImageView!
    @IBOutlet weak var photoWidthConstraint: NSLayoutConstraint!
    @IBOutlet weak var photoHeightConstraint: NSLayoutConstraint!
    
    // 提前配置固定的最大宽高，不要从frame中读取
    let maxContentWidth: CGFloat = UIScreen.main.bounds.width - 32 // 替换为你实际的内容左右边距
    let maxContentHeight: CGFloat = 350 // 替换为你实际允许的图片最大高度
    
    // 存储图片原始宽高，赋值后触发约束更新
    var imageSize: CGSize = .zero {
        didSet {
            setNeedsUpdateConstraints()
        }
    }
}

2. 重写Cell的updateConstraints方法，在Auto Layout布局阶段计算正确的约束常量，该方法执行时Cell及子视图的基础布局尺寸已经确定，不会拿到错误的frame值：

override func updateConstraints() {
    let imgWidth = imageSize.width
    let imgHeight = imageSize.height
    
    if imgWidth > 0, imgHeight > 0 {
        if imgWidth > imgHeight {
            let targetWidth = maxContentWidth
            let scale = targetWidth / imgWidth
            let targetHeight = imgHeight * scale
            photoWidthConstraint.constant = targetWidth
            photoHeightConstraint.constant = targetHeight
        } else {
            let targetHeight = maxContentHeight
            let scale = targetHeight / imgHeight
            let targetWidth = imgWidth * scale
            photoWidthConstraint.constant = targetWidth
            photoHeightConstraint.constant = targetHeight
        }
        photoWidthConstraint.isActive = true
        photoHeightConstraint.isActive = true
    }
    
    super.updateConstraints()
}

3. 补充复用重置逻辑，避免复用旧Cell时出现尺寸错乱：

override func prepareForReuse() {
    super.prepareForReuse()
    photoView.image = nil
    photoWidthConstraint.constant = 0
    photoHeightConstraint.constant = 0
    imageSize = .zero
}

4. 在cellForRowAt中只需要给Cell传递图片原始尺寸，不要手动调用约束计算方法：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "PhotoCell", for: indexPath) as! PhotoCell
    let data = imageList[indexPath.row]
    cell.imageSize = CGSize(width: data.originWidth, height: data.originHeight)
    // 执行你的图片加载逻辑
    // cell.photoView.loadImage(from: data.url)
    return cell
}

方案2：使用宽高比约束，彻底避免手动计算frame #

这是更稳定、性能更好的实现方式，完全不需要运行时读取frame计算尺寸：

• 横向图（宽大于高）：给photoView固定宽度为你设定的maxWidth，添加宽:高 = 图片原始宽:原始高的比例约束，系统会自动计算正确高度
• 竖向图（高大于等于宽）：给photoView固定高度为你设定的maxHeight，添加宽:高 = 图片原始宽:原始高的比例约束，系统会自动计算正确宽度

示例代码：

// 先移除之前添加的宽高比约束
photoView.constraints
    .filter { $0.firstAttribute == .width && $0.secondAttribute == .height }
    .forEach { $0.isActive = false }
// 添加新的宽高比约束
let ratio = imageSize.width / imageSize.height
photoView.widthAnchor.constraint(equalTo: photoView.heightAnchor, multiplier: ratio).isActive = true

这种方式完全由Auto Layout引擎负责尺寸计算，首次加载就会得到正确的布局结果，不会出现需要滚动后才正常的问题。

• 不要为了让约束立即生效，在cellForRowAt中调用cell.layoutIfNeeded()强制触发布局，这会让列表在滚动时频繁触发重复布局计算，导致严重的滚动卡顿。
• 不要把列表宽度、最大高度这类固定值放在布局计算阶段从frame读取，这类固定值可以在Cell初始化时就完成赋值，避免布局时序问题。

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