UIBarButtonItem失效：从B/C跳转至D时自定义按钮无响应

嘿，我来帮你搞定这个困扰你的问题！结合你的VC跳转结构和代码细节，这大概率是导航栈异常或者事件传递被拦截导致的，下面给你拆解几个核心原因和对应的修复办法：

1. 先修正代码里的语法错误！ #

你创建导航栏按钮的代码里有个明显的小失误：

// 错误写法
navigationItem.setLeftBarButton = UIBarButtonItem(customView: settingsButton)

应该改成：

// 正确写法
navigationItem.leftBarButtonItem = UIBarButtonItem(customView: settingsButton)

这个语法错误可能直接导致按钮根本没被正确添加到导航栏，自然无法响应点击！先把这个改了试试，很多时候这种小细节就是问题根源。

2. 导航栈重复push导致层级混乱 #

从你的跳转关系来看，A、B、C都能push到D，如果不小心多次触发了push操作（比如segue绑定重复或者代码里重复调用），导航栈里会存在多个D的实例，上层的D导航栏按钮的点击事件会被下层的视图拦截。

修复方案： #

在B或C触发跳转到D的操作前，先检查导航栈里是否已经存在D的实例，避免重复push：

// 在B/C的segue触发方法里添加检查
func goToD() {
    if let existingD = navigationController?.viewControllers.first(where: { $0 is DViewController }) {
        // 如果已经存在D，直接pop到该实例
        navigationController?.popToViewController(existingD, animated: true)
    } else {
        // 不存在则正常push
        performSegue(withIdentifier: "YourBDSegueID", sender: self)
    }
}

3. 自定义按钮的事件传递被拦截 #

你用自定义UIButton作为BarButtonItem的customView，可能因为约束问题或者交互开关被关闭导致无法接收点击事件。

修复方案： #

• 确保按钮及其父视图的isUserInteractionEnabled都是true（默认是true，但有时候会被误改）：

settingsButton.isUserInteractionEnabled = true
// 顺便检查BarButtonItem的customView容器
navigationItem.leftBarButtonItem?.customView?.isUserInteractionEnabled = true

• 优化按钮的创建代码，简化约束逻辑（iOS9+也可以保留约束，但确保约束正确）：

let settingsButton = UIButton(type: .custom)
settingsButton.setImage(UIImage(named: "settings-black.png"), for: .normal)
settingsButton.addTarget(self, action: #selector(settingsPressed), for: .touchUpInside)
settingsButton.imageEdgeInsets = UIEdgeInsets(top: 0, left: -10, bottom: 0, right: 10)
settingsButton.frame = CGRect(x: 0, y: 0, width: 35, height: 35)
// 直接创建BarButtonItem并赋值
navigationItem.leftBarButtonItem = UIBarButtonItem(customView: settingsButton)

4. 导航栏被自定义视图覆盖 #

如果B或C中自定义了导航栏（比如添加了背景覆盖视图），可能会覆盖D的导航栏区域，导致按钮点击被上层视图拦截。

修复方案： #

检查B/C的代码，看是否有类似这样的操作：

// 错误示例：添加了覆盖导航栏的视图
let overlayView = UIView(frame: navigationController?.navigationBar.bounds ?? .zero)
navigationController?.navigationBar.addSubview(overlayView)

如果有，要么把这个覆盖视图的isUserInteractionEnabled设为false，要么在push到D的时候移除该视图。

最后验证导航栈结构 #

你可以在D的viewDidAppear里打印导航栈，确认结构是否正常：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    let vcNames = navigationController?.viewControllers.map { String(describing: $0) } ?? []
    print("当前导航栈：\(vcNames)")
}

正常情况下，从B push到D的栈应该是[A, B, D]，从C push到D是[A, C, D]，如果出现重复的D或者其他异常，就说明segue触发逻辑有问题，需要进一步排查。

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