UITableViewCell内嵌UICollectionView首次加载高度异常问题求助

我帮你排查了代码里的几个核心问题，这些应该就是导致CollectionView首次加载时高度“跳变”的根源，下面是针对性的解决方案：

1. 修复DynamicHeightCollectionView的内在尺寸计算 #

原来的实现对contentSize变化的判断不够严谨，而且没有处理空内容的极端情况，修改后确保内在尺寸能准确跟随内容变化：

class DynamicHeightCollectionView: UICollectionView {
    override func layoutSubviews() {
        super.layoutSubviews()
        let newContentSize = contentSize
        // 仅当contentSize确实改变时才刷新内在尺寸
        if newContentSize != intrinsicContentSize {
            invalidateIntrinsicContentSize()
        }
    }

    override var intrinsicContentSize: CGSize {
        // 确保返回高度至少为1，避免0高度导致的布局异常
        let size = contentSize
        return CGSize(width: UIView.noIntrinsicMetric, height: max(size.height, 1))
    }
}

2. 修正MyHeaderView的sizeThatFits方法 #

原来的方法错误地直接返回CollectionView的contentSize，导致HeaderView无法计算自身完整尺寸，应该让contentView自行适配：

override func sizeThatFits(_ size: CGSize) -> CGSize {
    contentView.layoutIfNeeded()
    return contentView.sizeThatFits(size)
}

3. 调整CollectionView的约束逻辑 #

给CollectionView添加低优先级的高度约束，消除布局歧义，确保它的高度由内在尺寸决定：

tagsCollectionView.snp.makeConstraints { make in
    make.top.equalTo(identifierLabel.snp.bottom)
    make.leading.trailing.equalToSuperview()
    // 添加低优先级约束，辅助布局系统识别高度由内在尺寸决定
    make.height.equalTo(tagsCollectionView.intrinsicContentSize.height).priority(.low)
}

4. 修复MyTableViewCell的约束冲突 #

原来的HeaderView约束和StackView的布局逻辑冲突，移除错误约束并调整StackView的分布模式：

func commonInit() {
    self.addSubview(stackView)
    stackView.axis = .vertical
    stackView.spacing = 4
    stackView.distribution = .fill // 改为fill，让子视图自适应高度
    stackView.alignment = .fill
    stackView.addArrangedSubview(myHeaderView)

    stackView.snp.makeConstraints { make in
        make.edges.equalToSuperview().inset(UIEdgeInsets(top: 8, left: 8, bottom: 8, right: 8)) // 可选：添加内边距优化视觉
    }

    // 移除这行冲突的约束
    // myHeaderView.snp.makeConstraints { make in
    //     make.edges.equalToSuperview()
    // }
}

5. 开启TableView的自动行高 #

这是最容易被忽略的关键步骤，必须让TableView支持自适应行高：

// 在你的TableViewController的viewDidLoad中添加
override func viewDidLoad() {
    super.viewDidLoad()
    tableView.rowHeight = UITableView.automaticDimension
    tableView.estimatedRowHeight = 400 // 设置接近实际内容的预估高度，提升加载流畅度
}

6. 优化HeaderView的数据刷新逻辑 #

在刷新CollectionView后，强制触发布局更新，确保尺寸计算及时生效：

func setUpView(observation: Observation) {
    identifierLabel.text = observation.identifier
    statementLabel.text = observation.statement
    referenceIdLabel.text = observation.referenceID
    tagsArray = observation.tags ?? []
    
    tagsCollectionView.reloadData()
    // 强制刷新CollectionView布局，确保contentSize准确
    tagsCollectionView.layoutIfNeeded()
    // 触发HeaderView重新计算整体尺寸
    self.setNeedsLayout()
    self.layoutIfNeeded()
}

这些修改形成了从CollectionView到HeaderView再到TableViewCell的完整自适应链条，应该能彻底解决首次加载时高度异常的问题。

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