UITableView的cellForRowAt方法未调用问题求助

以下是几个可直接排查的方向：

• 检查UITableView的可见性与布局约束
  确认tableView未设置isHidden = true，同时核对其frame或Auto Layout约束：

  • 若tableView高度为0、位置完全超出屏幕范围，系统会判定无需绘制cell，进而跳过cellForRowAt调用。
  • 可在viewDidAppear中打印tableView.frame和tableView.contentSize，确认尺寸与内容区域是否符合预期。

• 确认Cell注册逻辑是否正确
  尽管dequeueReusableCell(withIdentifier:for:)未崩溃，但仍需核对注册步骤：

  • 代码创建的cell，需在viewDidLoad中执行：

    tableView.register(DetailPageTableViewCell.self, forCellReuseIdentifier: DetailPageTableViewCell.identifier)
    

  • XIB创建的cell，需执行：

    tableView.register(UINib(nibName: "DetailPageTableViewCell", bundle: nil), forCellReuseIdentifier: DetailPageTableViewCell.identifier)
    

  确保注册的identifier与dequeue时使用的完全一致。

• 验证reloadData的调用线程
  UI操作必须在主线程执行，若tableView.reloadData()在子线程调用，会导致刷新失效、cellForRowAt无法触发，可修改为：

  DispatchQueue.main.async {
      self.tableView.reloadData()
  }
  

• 排查干扰性代理方法
  若实现了tableView(_:estimatedHeightForRowAt:)，确保返回值不为0或不合理数值——错误的预估高度会导致系统判定cell无需显示；
  同时检查是否实现了tableView(_:heightForHeaderInSection:)或tableView(_:heightForFooterInSection:)，若返回值过大，会将cell挤出可视区域，导致cellForRowAt不被调用。

• 重新确认Delegate/DataSource绑定
  再次明确设置代理与数据源：

  tableView.delegate = self
  tableView.dataSource = self
  

  同时检查Storyboard/XIB中，tableView的delegate和dataSource是否正确连接到当前ViewController，避免IBOutlet连接错误。

• 测试简化场景
  暂时注释cell.configure(with: selectedItemVC)，返回一个默认UITableViewCell：

  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
      let cell = UITableViewCell(style: .default, reuseIdentifier: "test")
      cell.textLabel?.text = "Test Cell"
      return cell
  }
  

  若此时cellForRowAt能被调用，说明问题出在自定义cell的配置或初始化逻辑中。

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