UINavigationBar与UINavigationController不同步返回异常

点击导航栏返回按钮、或从屏幕左边缘滑动触发返回时，导航栏已切换到上一级页面样式，但对应页面未从导航栈出栈；滑动返回场景下导航栏动画不支持中断，异常效果如下：

复现环境为storyboard搭建的UIViewController嵌入UINavigationController结构，更换导航控制器实例、手动代码嵌入、移除外层嵌套的UITabBarController均无法解决问题；页面跳转使用navigationController?.pushViewController(vc, animated: true)实现，模态present不符合业务场景。

这类问题和控制器嵌套方式无关，核心是导航转场过程中状态机不同步：系统的pop交互触发后，导航栏的转场动画已经开始执行，但导航栈的出栈逻辑被中断/拦截，最终导致UI状态和栈内控制器数据不匹配。常见触发原因有三类：

• 自定义导航栏显隐逻辑时，未和系统转场上下文绑定，动画执行时序和系统pop动画冲突
• 自定义了interactivePopGestureRecognizer（侧滑返回手势）的代理，未正确实现手势判断逻辑，导致手势触发后转场中途被打断
• push页面时临时禁用侧滑返回，未在转场结束/取消的正确时机恢复手势状态，导致手势状态错乱

按优先级从高到低排查修改：

1. 修正导航栏显隐逻辑
   不要在viewWillAppear/viewWillDisappear里直接调用setNavigationBarHidden，必须将导航栏显隐动画和当前转场协调器绑定，避免动画时序冲突：

   override func viewWillAppear(_ animated: Bool) {
       super.viewWillAppear(animated)
       guard let nav = navigationController else { return }
       // 绑定系统转场动画，支持交互中断
       transitionCoordinator?.animate(alongsideTransition: { _ in
           nav.setNavigationBarHidden(/* 目标显隐状态，传入true为隐藏*/, animated: animated)
       }, completion: nil)
   }
   

   禁止用UIView.animate包裹导航栏显隐方法，会直接破坏系统转场的中断能力。

2. 还原/修正侧滑返回手势逻辑
   如果没有自定义转场动画，直接在导航控制器的viewDidLoad里还原手势默认配置即可：

   override func viewDidLoad() {
       super.viewDidLoad()
       interactivePopGestureRecognizer?.delegate = nil
       interactivePopGestureRecognizer?.isEnabled = true
   }
   

   如果需要自定义侧滑触发规则（比如根页面禁止侧滑），实现代理时必须补全手势共存逻辑，不要只做单一判断：

   extension CustomNavigationController: UIGestureRecognizerDelegate {
       func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
           // 仅当栈内控制器数大于1时允许触发pop，避免根页面响应手势卡死
           return viewControllers.count > 1
       }
       // 允许手势和其他交互共存，避免转场中途无法响应中断
       func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
           return true
       }
   }
   

3. 修正push时的手势状态管理
   如果业务需要在push动画过程中临时禁用侧滑，不要在viewDidAppear里才恢复手势，要通过转场协调器监听转场状态，在转场结束/取消时及时恢复：

   navigationController?.pushViewController(targetVC, animated: true)
   navigationController?.transitionCoordinator?.notifyWhenInteractionChanges({ [weak self] context in
       // 转场被取消/完成后恢复手势可用状态
       self?.interactivePopGestureRecognizer?.isEnabled = true
   })
   

排查技巧：复现问题时断点打印navigationController?.viewControllers.count，如果触发返回操作时栈内控制器数量没有减少，但导航栏已经切换样式，即可确认是上述转场状态不同步问题，按步骤修改即可解决。

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