UITableView重载Section时头部线条绘制异常问题咨询

这问题我之前做项目时也踩过坑！核心原因是reloadSections触发刷新时，Header视图的布局还没完全完成就执行了绘制逻辑，导致拿到的frame是零值；而reloadData会等待整个TableView的布局流程走完再渲染，所以能拿到正确的frame。下面给你几个实用的解决办法：

1. 将绘制逻辑移到layoutSubviews()中（最推荐） #

UIKit中layoutSubviews()方法会在视图的frame确定且布局完成后被调用，不管是reloadData还是reloadSections触发的刷新，只要Header的尺寸确定，这个方法就会执行。把线条绘制逻辑放在这里，能从根源上避免frame为零的问题：

class CustomSectionHeader: UITableViewHeaderFooterView {
    override func layoutSubviews() {
        super.layoutSubviews()
        // 在这里执行线条绘制逻辑
        drawSeparatorLine()
    }
    
    private func drawSeparatorLine() {
        // 先移除已有的线条，避免重复绘制
        subviews.filter { $0.tag == 999 }.forEach { $0.removeFromSuperview() }
        
        // 基于contentView的bounds计算线条位置
        let lineHeight: CGFloat = 1
        let lineFrame = CGRect(
            x: 16,
            y: contentView.bounds.height - lineHeight,
            width: contentView.bounds.width - 32,
            height: lineHeight
        )
        
        let lineView = UIView(frame: lineFrame)
        lineView.backgroundColor = UIColor.lightGray
        lineView.tag = 999
        contentView.addSubview(lineView)
    }
}

2. 强制触发布局后再绘制 #

如果你的绘制逻辑必须放在特定方法（比如自定义的configure配置方法）里，可以在调用绘制前强制让Header完成布局：

// 在Header的配置方法中
func configure(with data: YourDataModel) {
    // 先更新Header的内容
    self.titleLabel.text = data.title
    
    // 强制触发布局，确保拿到正确的frame
    self.setNeedsLayout()
    self.layoutIfNeeded()
    
    // 再执行绘制
    drawSeparatorLine()
}

或者在调用reloadSections后，强制TableView完成布局：

notesTable.reloadSections([1], with: .automatic)
notesTable.layoutIfNeeded()

3. 利用TableView代理方法willDisplayHeaderView #

这个代理方法会在Header即将显示在屏幕上时被调用，此时Header已经完成布局，能拿到正确的frame：

extension YourViewController: UITableViewDelegate {
    func tableView(_ tableView: UITableView, willDisplayHeaderView view: UIView, forSection section: Int) {
        guard let headerView = view as? CustomSectionHeader else { return }
        // 在这里触发绘制
        headerView.drawSeparatorLine()
    }
}

总结 #

优先推荐第一种方法，把绘制逻辑放到layoutSubviews里是UIKit视图布局的标准做法，适配所有刷新场景且稳定性最高。另外两种方法可以根据你的代码结构灵活选择。

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