UITableView无法设置动态行高 使用automaticDimension单元格不显示如何解决

核心排查步骤 #

• 第一步：验证cell约束完整性
  自动行高生效的核心是cell的contentView存在完整的垂直约束链：

  所有子控件的垂直方向约束必须覆盖从contentView顶部到contentView底部的全链路，无歧义。
  注意要点：

  1. 所有约束必须添加到cell的contentView上，而非cell本身
  2. 可多行显示的文本控件（UILabel/UITextView）必须将numberOfLines设为0
  3. 最底部的子控件必须和contentView底部设置明确的间距约束
  4. 运行时检查Xcode控制台是否输出约束冲突日志，优先解决所有约束冲突

• 第二步：清理重复配置避免冲突
  如果你已经全局配置了自动行高，无需再实现heightForRowAt indexPath代理方法，直接删除该方法的实现即可，避免代理优先级高于全局配置导致异常：

  // 仅保留这两行全局配置即可，无需实现heightForRowAt
  self.tableView.estimatedRowHeight = 200 // 建议填写接近实际平均高度的固定预估数值，比用automaticDimension更稳定
  self.tableView.rowHeight = UITableView.automaticDimension
  

  同时检查Storyboard中TableView的配置：

  1. 取消勾选Row Height的自定义固定值，恢复默认
  2. 若有自定义Estimated Row Height，确保和代码配置一致

• 第三步：验证动态内容刷新逻辑
  如果cell的内容是异步加载（比如网络请求后赋值），内容更新后必须触发行高刷新：

  // 内容赋值完成后调用
  tableView.beginUpdates()
  tableView.endUpdates()
  // 或者刷新指定行
  tableView.reloadRows(at: [indexPath], with: .none)
  

• 第四步：最简场景验证
  如果以上步骤都无法解决，先做最小化测试定位问题：

  1. 在xib的cell中仅保留1个UILabel，设置numberOfLines = 0，给Label添加相对于contentView的top/leading/trailing/bottom四个固定间距约束
  2. 清空所有height相关的代理方法，仅保留全局的自动行高配置
  3. 给Label赋值一段长文本运行测试，若此时自动行高生效，则说明原业务cell的约束存在问题，逐行排查原cell的约束即可。

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