UITabBarController异常：切换标签控制器消失、TabItem不显示

我最近帮开发者排查过两起和UITabBarController + UISearchController相关的诡异问题，正好和你遇到的情况完全匹配：

• 切换Tab后对应的UIViewController突然消失
• 某款TabBar应用中，某个TabItem毫无征兆地不再显示

问题根源 #

这两个问题的核心都是UISearchController的视图层级管理和UITabBarController的Tab切换逻辑冲突：当UISearchController处于激活状态（即搜索界面显示中）时切换Tab，系统的视图移除/添加逻辑会出现异常，要么把原控制器的视图从层级中误移除，要么破坏了TabBarItem和控制器的关联关系。

可行解决方案 #

1. 切换Tab前强制关闭UISearchController

最直接有效的方法是在Tab切换触发时，先关闭当前活跃的搜索控制器，避免视图层级混乱。你可以通过两种方式实现：

方式一：通过UITabBarController代理监听切换

在AppDelegate或者TabBarController子类中实现代理方法：

// 假设在AppDelegate中初始化TabBar
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    let tabBarVC = UITabBarController()
    // 初始化你的子控制器数组...
    tabBarVC.viewControllers = [vc1, vc2, vc3]
    
    // 设置代理
    tabBarVC.delegate = self
    window?.rootViewController = tabBarVC
    window?.makeKeyAndVisible()
    return true
}

// 扩展实现UITabBarControllerDelegate
extension AppDelegate: UITabBarControllerDelegate {
    func tabBarController(_ tabBarController: UITabBarController, shouldSelect viewController: UIViewController) -> Bool {
        // 检查当前选中的控制器是否有活跃的搜索控制器
        if let navVC = tabBarController.selectedViewController as? UINavigationController,
           let topVC = navVC.topViewController,
           let searchVC = topVC.navigationItem.searchController,
           searchVC.isActive {
            // 立即关闭搜索界面
            searchVC.dismiss(animated: false)
        }
        return true
    }
}

方式二：在子控制器的生命周期中处理

如果你的子控制器是自定义的，可以在视图即将消失时关闭搜索控制器：

class SearchEnabledVC: UIViewController {
    override func viewWillDisappear(_ animated: Bool) {
        super.viewWillDisappear(animated)
        // 关闭搜索控制器
        navigationItem.searchController?.dismiss(animated: false)
    }
}

2. 修正UISearchController的配置

确保你的搜索控制器没有干扰TabBar的视图层级：

• 若使用导航栏，设置searchController.hidesNavigationBarDuringPresentation = false，避免导航栏隐藏导致TabBar的布局偏移或视图层级混乱
• 不要手动将searchController的视图添加到TabBarController的视图中，正确的做法是关联到导航栏的navigationItem.searchController

3. 修复TabItem消失的问题

如果已经出现TabItem消失的情况，可以强制刷新TabBar的items来恢复：

// 在TabBarController中调用，或者在切换Tab时触发
tabBar.setItems(tabBar.items, animated: true)

另外，也可以检查对应控制器的tabBarItem是否被意外置空，若为空则重新赋值：

// 给消失的Tab对应的控制器重新设置TabBarItem
vc.tabBarItem = UITabBarItem(title: "首页", image: UIImage(named: "home"), selectedImage: UIImage(named: "home_selected"))

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