添加UISearchController后UITableView出现过度上滑问题求助

我之前也碰到过一模一样的情况——给UITableView加上UISearchController后，列表能往上滑出一大段空白，这大多是布局约束或者系统默认的搜索控制器属性设置不对导致的。下面是几个亲测有效的解决办法：

1. 正确配置UISearchController的核心属性 #

首先检查你的searchController初始化代码，把obscuresBackgroundDuringPresentation设为false，这个属性默认是true，会让系统添加一个模糊背景视图，很容易打乱tableView的布局计算：

lazy var searchController: UISearchController = {
    let sc = UISearchController(searchResultsController: searchCardController)
    // 关键：禁用模糊背景，避免布局偏移
    sc.obscuresBackgroundDuringPresentation = false
    sc.searchBar.placeholder = "搜索你的卡片"
    return sc
}()

2. 规范设置searchBar作为tableHeaderView的布局 #

直接把searchBar赋值给tableHeaderView时，一定要先让它适配尺寸，再确保自动布局约束正确，不然searchBar的高度可能被计算错误，导致tableView多出额外的滚动空间：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 先让searchBar自动适配尺寸
    searchController.searchBar.sizeToFit()
    // 设置为tableHeaderView
    tableView.tableHeaderView = searchController.searchBar
    
    // 如果用自动布局，记得关闭自动转换约束并添加明确约束
    searchController.searchBar.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        searchController.searchBar.leadingAnchor.constraint(equalTo: tableView.leadingAnchor),
        searchController.searchBar.trailingAnchor.constraint(equalTo: tableView.trailingAnchor),
        searchController.searchBar.topAnchor.constraint(equalTo: tableView.topAnchor),
        // 可以固定高度或者让它自适应，44是searchBar的标准高度
        searchController.searchBar.heightAnchor.constraint(equalToConstant: 44)
    ])
}

3. 调整滚动视图的内边距适配（iOS 11+） #

如果你的视图控制器嵌套在UINavigationController里，iOS 11及以上系统会自动调整scrollView的contentInset，这可能和searchBar的布局冲突。可以手动设置contentInsetAdjustmentBehavior：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 根据你的需求选择，.never会关闭自动调整，避免额外内边距导致过度滚动
    tableView.contentInsetAdjustmentBehavior = .never
    // 如果需要保留导航栏的内边距适配，也可以用.automatic，但要确保searchBar的布局没问题
}

4. 重置tableView的contentInset和滚动指示器内边距 #

有时候某些第三方库或者系统操作会意外修改tableView的contentInset，你可以在viewDidAppear里重置一下：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    
    tableView.contentInset = UIEdgeInsets.zero
    tableView.scrollIndicatorInsets = tableView.contentInset
}

如果开启了导航栏的大标题（prefersLargeTitles = true），还要记得把searchController.hidesNavigationBarDuringPresentation设为false，不然搜索时导航栏隐藏也可能导致滚动异常。

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