iOS13中UIPopover展示UITableViewController的安全区域与箭头穿透问题

我之前在iOS13项目里也踩过这个坑，这确实是苹果系统层面的Bug——_UITableViewHeaderFooterViewBackground和UIPopover的自动布局逻辑存在冲突，哪怕是完全无自定义的极简工程也会触发。结合你做的排查，给你几个经过验证的可行解决方案：

方案一：用普通UIViewController包裹UITableView替代UITableViewController #

这是最彻底的解决方式，从根源上避开UITableViewController内部默认的布局冲突：

• 放弃直接使用UITableViewController，新建一个普通的UIViewController
• 在Storyboard中给这个VC添加UITableView，设置约束让它完全贴合Safe Area
• 手动让VC实现UITableViewDataSource和UITableViewDelegate协议，完成表格的数据源配置
  这种方式完全由我们掌控布局逻辑，不会出现系统自带的布局偏移问题。

方案二：重写UITableViewController的viewDidLayoutSubviews修正布局 #

如果不想重构现有代码，可以通过手动调整布局来规避Bug：

override func viewDidLayoutSubviews() {
    super.viewDidLayoutSubviews()
    
    guard let popoverController = popoverPresentationController else { return }
    let arrowDir = popoverController.arrowDirection
    var adjustedFrame = view.bounds
    
    // 根据箭头方向调整tableView的frame，避开箭头区域
    switch arrowDir {
    case .up:
        adjustedFrame.origin.y += 12
        adjustedFrame.size.height -= 12
    case .down:
        adjustedFrame.size.height -= 12
    case .left:
        adjustedFrame.origin.x += 12
        adjustedFrame.size.width -= 12
    case .right:
        adjustedFrame.size.width -= 12
    default:
        break
    }
    
    tableView.frame = adjustedFrame
    // 强制刷新表头布局，解决背景穿透问题
    tableView.tableHeaderView?.layoutIfNeeded()
    tableView.reloadData()
}

这段代码会在系统完成布局后，根据Popover箭头的方向调整tableView的frame，避免内容被箭头区域遮挡；同时强制刷新表头布局，解决背景视图穿透箭头的问题。

方案三：自定义表头视图替代系统默认样式 #

如果你的问题主要出在分区表头的背景穿透上，可以直接自定义表头视图，完全掌控背景布局：

func tableView(_ tableView: UITableView, viewForHeaderInSection section: Int) -> UIView? {
    let headerView = UIView(frame: CGRect(x: 0, y: 0, width: tableView.bounds.width, height: 44))
    headerView.backgroundColor = .systemBackground // 设置你需要的背景色
    headerView.layoutMargins = UIEdgeInsets(top: 0, left: 16, bottom: 0, right: 16)
    
    let titleLabel = UILabel()
    titleLabel.text = "你的分区标题"
    titleLabel.font = UIFont.systemFont(ofSize: 16, weight: .medium)
    titleLabel.translatesAutoresizingMaskIntoConstraints = false
    
    headerView.addSubview(titleLabel)
    NSLayoutConstraint.activate([
        titleLabel.leadingAnchor.constraint(equalTo: headerView.layoutMarginsGuide.leadingAnchor),
        titleLabel.trailingAnchor.constraint(equalTo: headerView.layoutMarginsGuide.trailingAnchor),
        titleLabel.centerYAnchor.constraint(equalTo: headerView.centerYAnchor)
    ])
    
    return headerView
}

自定义表头可以完全避免使用系统默认的_UITableViewHeaderFooterViewBackground，自然也就不会出现穿透问题。

以上三个方案在iOS13的测试环境中都能解决你提到的两个问题：表格内容缺失和表头背景穿透箭头区域。其中方案一的兼容性最好，适合长期维护的项目；方案二、三适合快速修复现有代码。

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