UITabBarController中使用UISearchController：导航栏折叠时出现异常白线

嘿，我之前也碰到过这个烦人的白线问题！咱们一步步来拆解原因和靠谱的解决办法：

问题成因 #

这条白线大概率是导航栏半透明特性和UISearchController的布局交互导致的：
当导航栏默认保持半透明（navigationBar.isTranslucent = true）时，系统会自动调整视图的布局内边距，但UISearchController的搜索框激活时，和导航栏底部的默认阴影/分隔线出现了重叠或布局偏移，就露出了这条扎眼的白线。另外，如果没自定义导航栏的背景图和阴影图，系统默认的阴影元素也可能在搜索框激活时“漏”出来。

修复方法 #

方法一：隐藏导航栏默认阴影（最推荐） #

直接去掉导航栏的默认阴影图，从根源上消除白线的来源，而且不会改变原有交互逻辑：

override func viewDidLoad() {
    super.viewDidLoad()
    // 配置搜索控制器的代码
    searchController.searchResultsUpdater = self
    searchController.obscuresBackgroundDuringPresentation = false // 建议保持这个设置，避免背景变黑
    
    // 关键代码：隐藏导航栏阴影和默认背景图
    navigationController?.navigationBar.shadowImage = UIImage()
    navigationController?.navigationBar.setBackgroundImage(UIImage(), for: .default)
    
    // 如果需要自定义导航栏背景色，记得加这行
    navigationController?.navigationBar.barTintColor = .yourCustomColor
}

方法二：调整搜索控制器的导航栏隐藏设置 #

如果你的业务允许搜索框激活时导航栏不隐藏，可以修改这个属性，避免布局突变带来的白线：

searchController.hidesNavigationBarDuringPresentation = false

注意：这个会改变搜索框激活时的界面表现，需要结合你的产品需求选择。

方法三：手动修正布局内边距 #

如果上面的方法都没效果，试试手动调整视图的安全区内边距，抵消半透明导航栏的布局偏移：

override func viewDidLoad() {
    super.viewDidLoad()
    // 其他配置代码...
    if let navBarHeight = navigationController?.navigationBar.frame.height {
        view.additionalSafeAreaInsets = UIEdgeInsets(top: navBarHeight, left: 0, bottom: 0, right: 0)
    }
}

方法四：自定义搜索框背景样式 #

有时候搜索框的默认背景会和导航栏产生冲突，可以自定义搜索框的背景来规避：

let searchBar = searchController.searchBar
// 去掉搜索框默认背景
searchBar.backgroundImage = UIImage()
// 给搜索输入框设置自定义背景色
searchBar.searchTextField.backgroundColor = .white

总结 #

优先试试方法一，它是最温和且有效的解决方案，既能保留导航栏半透明的特性，又能彻底消除白线问题。

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