Xcode14.2(UIKit)：静态UITableView空section footer浮至键盘顶部遮挡UITextView

问题背景 #

在Xcode 14.2的UIKit开发场景中，使用静态UITableView作为输入表单，共包含3个section，最后一个section的cell内嵌入了约束到cell边距的UITextView。

出现以下异常：

• 键盘弹出后，选中第3个section的UITextView或手动滚动视图时，键盘顶部会出现一个浅灰色空section footer条
• 该条会遮挡正在编辑的UITextView，添加基于键盘高度的偏移仅会拉大其与键盘的间距，无法解决遮挡
• 当第3个section完全可见时，灰色条自动消失
• 当前视图不需要section footer，注释掉viewDidLoad中用于UITextView自适应高度的代码后问题仍存在：

  override func viewDidLoad() {
      super.viewDidLoad()
      
      notesTextView.delegate = self
      notesTextView.isScrollEnabled = false
  }
  

排查与解决步骤 #

1. 检查Storyboard/XIB的静态表配置 #

打开对应界面的Storyboard/XIB，逐一检查3个section的footer设置：

• 确认所有section的Footer选项设置为None，无意外添加的空白footer视图
• 检查每个section的Footer Height属性，直接设置为0（若使用自动布局，也需确保无内容支撑footer高度）

2. 代码层面强制禁用所有section footer #

在ViewController中添加以下UITableView代理方法，强制覆盖系统的footer逻辑：

override func tableView(_ tableView: UITableView, viewForFooterInSection section: Int) -> UIView? {
    return nil // 所有section均不返回footer视图
}

override func tableView(_ tableView: UITableView, heightForFooterInSection section: Int) -> CGFloat {
    return CGFloat.leastNormalMagnitude // 设置为最小非零值，避免系统自动生成空白区域
}

静态UITableView有时会默认生成空footer，通过代理方法强制覆盖可以彻底清除这类异常视图。

3. 修正键盘适配逻辑 #

若之前有自定义键盘弹出的滚动偏移代码，建议改用UITableView自带的适配机制：

override func viewDidLoad() {
    super.viewDidLoad()
    // 保留原有TextView配置（若需要自适应高度）
    notesTextView.delegate = self
    notesTextView.isScrollEnabled = false
    
    // 启用系统自带的键盘适配
    tableView.keyboardDismissMode = .interactive
    tableView.contentInsetAdjustmentBehavior = .automatic
}

避免手动计算偏移导致的布局异常，让系统自动处理键盘弹出时的滚动适配。

4. 检查UITextView与cell的布局约束 #

• 确认最后一个section的cell内，UITextView的约束完全绑定到cell的contentView边缘，无多余约束导致cell高度计算错误
• 确保cell的Row Height设置为Automatic，并正确实现UITextView的自适应高度逻辑（若需要），避免cell高度异常触发系统的footer补偿布局

5. 清理Xcode缓存 #

若以上步骤无效，尝试清除Xcode缓存解决布局异常：

• 使用快捷键Command + Shift + K清理项目缓存
• 删除~/Library/Developer/Xcode/DerivedData目录下对应项目的文件夹
• 重启Xcode后重新运行项目

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