键盘动画引发UITableView分区表头异常问题求助

我之前也碰到过几乎一模一样的问题！当时折腾了好一阵才找到根源，给你分享几个排查方向和解决办法：

可能的原因1：键盘消失时的布局回退动画未触发TableView重绘 #

当你在键盘弹出时修改底部UIView的frame或约束，键盘消失后如果只把底部View移回原位，却没通知TableView更新布局，很可能导致表头的frame计算错误。

• 解决办法：在键盘消失的动画完成回调里，调用tableView.layoutIfNeeded()或者tableView.reloadSections(IndexSet(integer: 0), with: .automatic)，强制让TableView重新计算表头和单元格的布局。

示例代码参考：

@objc func keyboardWillHide(_ notification: Notification) {
    guard let keyboardFrame = notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect else { return }
    let duration = notification.userInfo?[UIResponder.keyboardAnimationDurationUserInfoKey] as? Double ?? 0.3
    
    UIView.animate(withDuration: duration) {
        // 将底部UIView恢复原位的代码
        self.bottomView.transform = .identity
        // 强制更新整体布局
        self.view.layoutIfNeeded()
    } completion: { _ in
        // 动画完成后刷新第一个分区
        self.tableView.reloadSections(IndexSet(integer: 0), with: .fade)
    }
}

可能的原因2：TableView的contentInset未正确恢复 #

有些场景下为了避免键盘遮挡TableView内容，会在键盘弹出时调整contentInset，但键盘消失时忘记重置，这也会干扰表头的显示位置。

• 解决办法：先保存TableView初始的contentInset，在键盘消失时恢复这个值：

// 保存初始的contentInset
var originalContentInset: UIEdgeInsets!

override func viewDidLoad() {
    super.viewDidLoad()
    originalContentInset = tableView.contentInset
}

@objc func keyboardWillHide(_ notification: Notification) {
    let duration = notification.userInfo?[UIResponder.keyboardAnimationDurationUserInfoKey] as? Double ?? 0.3
    
    UIView.animate(withDuration: duration) {
        self.tableView.contentInset = self.originalContentInset
        self.tableView.scrollIndicatorInsets = self.originalContentInset
    }
}

可能的原因3：自定义分区表头的布局约束有疏漏 #

如果你的表头是自定义的UITableViewHeaderFooterView，可能存在约束设置错误，当父视图（TableView）布局变化时，表头自身的约束无法正确更新。

• 解决办法：检查自定义表头的约束是否完整，确保top、bottom、leading、trailing都与父视图正确关联，没有固定高度或错误的优先级设置。另外可以在表头的layoutSubviews()方法中打印frame，对比键盘消失前后的变化，定位具体问题。

额外排查技巧 #

• 打开Xcode的Debug View Hierarchy，在键盘消失后查看TableView和表头的frame，确认是否是表头的y坐标偏移或被其他视图遮挡。
• 检查是否有其他代码在修改TableView的contentOffset，比如自动滚动逻辑，可能在键盘消失后干扰表头位置。

我当时是因为键盘消失时只做了底部View的动画，没调用layoutIfNeeded()导致TableView布局未更新，再加上自定义表头的约束有问题，结合上面的方法就解决了。你可以先试试第一个办法，应该能覆盖大部分情况！

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