iOS 11导航栏搭配Search Controller出现异常行为

我之前接手过几个iOS11后停更的老应用，也遇到过类似的SearchController迁移问题，结合你的场景，咱们一步步梳理可能的问题点和解决办法：

1. 先排查旧titleView的残留干扰 #

你之前是把SearchController的view作为navigationItem.titleView来显示，换成系统的searchController属性后，很可能旧的titleView引用没有彻底清除，导致视图层级冲突。

• 解决步骤：
  • 在设置navigationItem.searchController = yourSearchController之前，务必先执行navigationItem.titleView = nil
  • 检查整个视图控制器的生命周期方法（比如viewDidLoad、viewWillAppear），确保没有其他地方再给titleView赋值的代码，尤其是低版本兼容的分支里

2. 检查SearchController的核心配置差异 #

系统的navigationItem.searchController有一些默认行为，和你之前手动塞titleView的逻辑可能不一致：

• obscuresBackgroundDuringPresentation：iOS11+默认是true，会在搜索时模糊背景，如果你的旧逻辑是背景不模糊，需要手动设为false
• hidesNavigationBarDuringPresentation：默认true，搜索时会隐藏导航栏，如果需要保持导航栏可见，要设为false
• hidesSearchBarWhenScrolling：默认true，滚动时会收起搜索栏，如果要让它始终固定在顶部，设为false

3. 排查导航栏自定义导致的布局冲突 #

老应用通常会自定义导航栏的外观（比如高度、背景色、标题样式），这些自定义可能和系统管理的SearchController布局冲突：

• 如果用了自定义的UINavigationBar子类，检查是否重写了layoutSubviews，有没有干扰SearchBar的布局计算
• 检查prefersLargeTitles设置，大标题模式下的SearchController布局逻辑和普通模式不同，如果不需要大标题，确保navigationController?.navigationBar.prefersLargeTitles = false

4. 确认视图控制器生命周期的设置时机 #

建议在viewDidLoad里完成SearchController的配置和赋值，而不是viewWillAppear：

• 系统需要在控制器初始化阶段就感知到SearchController的存在，才能正确处理push/pop时的过渡动画
• 如果在viewWillAppear里重复设置，可能导致每次进入页面都重建SearchController，引发异常

参考正确的配置代码示例 #

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 彻底清除旧的titleView引用
    navigationItem.titleView = nil
    
    // 初始化并配置SearchController
    let searchResultsVC = YourSearchResultsViewController()
    let searchController = UISearchController(searchResultsController: searchResultsVC)
    
    // 适配旧应用的交互逻辑
    searchController.searchBar.placeholder = "请输入关键词搜索"
    searchController.obscuresBackgroundDuringPresentation = false
    searchController.hidesNavigationBarDuringPresentation = false
    
    // 绑定到navigationItem
    navigationItem.searchController = searchController
    // 让搜索栏始终显示在顶部（可选）
    navigationItem.hidesSearchBarWhenScrolling = false
}

如果你的异常有具体表现（比如搜索栏不显示、过渡动画卡顿、布局错位），可以补充细节后再精准定位，但先从上面几个方向排查应该能解决大部分问题。

内容的提问来源于stack exchange，提问作者Szilárd Dőrő