跳转至SideMenuController时UITableView自动高度失效是什么原因？

核心错误原因 #

• 执行顺序错误：viewDidLayoutSubviews中先更新高度约束再执行reloadData，reloadData会触发TableView重新计算内容尺寸、触发新一轮布局，导致高度赋值失效，同时进入死循环
• 缺少必要的高度配置：仅实现estimatedHeightForRowAt代理方法，未全局设置TableView的rowHeight为自动尺寸
• 刷新时机错误：未适配登出跳转场景下的页面生命周期，数据刷新时机和高度计算时机不匹配

修复代码 #

第一步：调整TableView基础配置与刷新逻辑 #

@IBOutlet weak var spicesTableViewHeight: NSLayoutConstraint!

override func viewDidLoad() {
    super.viewDidLoad()
    // 全局配置自适应行高，仅靠代理方法配置不完整
    spicesTableView.rowHeight = UITableView.automaticDimension
    // 填写接近实际行高的估算值，提升计算性能
    spicesTableView.estimatedRowHeight = 80
}

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    // 登出跳转后页面显示时主动刷新数据，适配数据变更场景
    spicesTableView.reloadData()
}

第二步：修正高度计算逻辑 #

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    let targetHeight = spicesTableView.contentSize.height
    // 仅当高度发生变化时更新约束，避免触发不必要的布局循环
    guard spicesTableViewHeight.constant != targetHeight else {
        return
    }
    spicesTableViewHeight.constant = targetHeight
    // 强制立即刷新布局，让约束变更立刻生效
    view.layoutIfNeeded()
}

第三步：可选优化（适配异步加载数据场景） #

如果列表数据是异步请求获取的，在数据请求完成后手动触发一次高度更新，避免延迟导致的高度错误：

// 数据请求完成回调方法示例
func didLoadSpicesList(_ list: [SpiceModel]) {
    self.spicesList = list
    spicesTableView.reloadData()
    // 强制TableView立即布局后更新高度约束
    spicesTableView.layoutIfNeeded()
    spicesTableViewHeight.constant = spicesTableView.contentSize.height
    view.layoutIfNeeded()
}

额外注意事项 #

• 如果TableView嵌套在UIScrollView等可滚动容器中，需要确保父容器的垂直方向约束完整，不存在未确定的高度值
• 不要在viewDidLayoutSubviews中调用任何会触发布局更新的方法，包括reloadData、layoutIfNeeded的无条件调用

内容的提问来源于stack exchange，提问作者Er Adarsh Raj