首次加载时TableView Cell高度未匹配CollectionView高度问题

我之前也踩过这种嵌套布局的高度自适应坑，结合你描述的场景（四边对齐约束+999优先级高度约束），给你几个亲测有效的解决方案：

问题根源分析 #

你现在的约束设置逻辑是对的，但直接在cellForItemAt里修改高度往往不生效——因为TableView Cell的布局周期和CollectionView的布局周期是独立的，光改约束值不会触发系统重新计算整个Cell的高度，必须手动触发布局更新。

方案一：手动计算高度+强制触发布局更新 #

这是最直接的解决方式，适合快速调试：

1. 先给CollectionView的高度约束加个IBOutlet，比如命名为collectionViewHeightConstraint
2. 在数据更新完成后（比如cellForItemAt里或者数据回调中），执行以下代码：

// 先让CollectionView完成当前布局，确保拿到最新的contentSize
collectionView.layoutIfNeeded()
// 更新高度约束值为CollectionView的实际内容高度
collectionViewHeightConstraint.constant = collectionView.contentSize.height
// 触发Cell内部布局更新
cell.contentView.layoutIfNeeded()
// 强制TableView重新计算当前Cell的高度，这一步是关键！
tableView.beginUpdates()
tableView.endUpdates()

方案二：让CollectionView自动驱动高度（推荐） #

这种方式更符合AutoLayout的设计逻辑，不需要手动维护高度值：

1. 保持你现有的四边对齐约束+999优先级高度约束不变
2. 给CollectionView设置isScrollEnabled = false（禁止滚动，让它变成“静态容器”）
3. 在CollectionView的代理中明确每个Item的尺寸（实现collectionView(_:layout:sizeForItemAt:)）
4. 在TableView Cell的layoutSubviews方法中同步高度约束：

override func layoutSubviews() {
    super.layoutSubviews()
    // 确保CollectionView先完成布局
    collectionView.layoutIfNeeded()
    // 找到高度约束并更新为内容高度
    if let heightConstraint = collectionView.constraints.first(where: { $0.firstAttribute == .height }) {
        heightConstraint.constant = collectionView.contentSize.height
    }
}

5. 别忘了给TableView设置自动计算行高：

tableView.estimatedRowHeight = 200 // 设一个接近实际高度的预估值
tableView.rowHeight = UITableView.automaticDimension

方案三：彻底避免嵌套布局（性能最优） #

如果你的业务场景允许，建议把TableView和CollectionView合并成一个UICollectionView：

• 用不同的Section来实现原来TableView Cell的分组效果
• 用不同的Cell类型区分原TableView Cell和CollectionView Item
  这种方式既没有高度自适应的问题，整体性能也会更好。

额外注意点 #

• 别忽略CollectionView的contentInset、sectionInset，这些会直接影响contentSize的计算
• 如果是异步加载数据，一定要在数据回调完成后再刷新CollectionView和TableView
• 尽量避免在cellForItemAt里做大量布局计算，会影响TableView的滑动性能

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