Swift UISearchController无法激活、无光标无键盘问题排查求助

调试定位步骤 #

• 先用Xcode内置的Debug View Hierarchy工具排查视图层级：确认没有透明的自定义视图、CollectionView头部视图超出父视图范围，覆盖在SearchBar的响应区域上；返回按钮可正常点击说明导航栏整体未被遮挡，仅需排查SearchBar同级的上层视图即可。
• 断点调试searchBarShouldBeginEditing代理方法：如果点击SearchBar后该方法未触发，说明点击事件被上层手势/视图拦截。
• 对比三个页面的控制器配置差异：重点检查当前页面的CollectionView手势配置、导航栏属性设置、是否有自定义的全局手势拦截逻辑。

常见解决方案 #

1. 修正属性赋值错误
   你当前代码中definesPresentationContext的赋值对象错误，该属性是UIViewController的原生属性，需要配置给当前控制器而非UISearchController，修改代码：

// 删掉错误代码 self.searchController.definesPresentationContext = true
// 替换为
self.definesPresentationContext = true

2. 解决CollectionView手势冲突
   UICollectionView的默认点击手势可能会拦截SearchBar的响应，添加以下手势代理方法即可：

extension ViewBusinessProfile: UIGestureRecognizerDelegate {
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 允许SearchBar的手势和CollectionView手势同时响应
        return otherGestureRecognizer.view is UISearchBar
    }
}

同时在viewDidLoad中添加配置：

collectionViews.panGestureRecognizer.delegate = self

3. 适配导航栏配置
   如果当前页面导航栏的半透明属性和其他两个正常页面不一致，统一配置即可：

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    navigationController?.navigationBar.isTranslucent = true
    // 每次页面显示重新赋值titleView，避免跳转后状态异常
    navigationItem.titleView = searchController.searchBar
}

4. 强制开启SearchBar交互
   确认没有其他代码修改SearchBar的交互开关，可主动配置：

searchController.searchBar.isUserInteractionEnabled = true

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