iOS导航栏UIBarButtonItem点击无响应 关联addTap方法未触发

• Target/Action绑定流程存在错误
  这是触发失败的最高发原因：
  • 纯代码初始化UIBarButtonItem时，未正确传入target和action参数，比如传nil、传入已经被释放的临时对象，导致按钮没有关联任何可响应的方法，示例错误写法：

    // 错误：target和action均为空，点击无任何反应
    navigationItem.rightBarButtonItem = UIBarButtonItem(
      barButtonSystemItem: .add,
      target: nil,
      action: nil
    )
    

  • 使用#selector关联方法时，拼写错误方法名、自定义导航栏控件未正确将按钮事件传递给所属控制器，或是Storyboard/Xib拖拽的事件连线断裂、错误连到了非当前控制器的对象上。
• 响应方法不满足Runtime调用要求
  UIBarButtonItem的事件触发依赖Objective-C Runtime的消息转发逻辑，以下写法会导致系统找不到对应方法，即使绑定步骤正确也无法触发：
  • 给addTap方法漏加@objc标记，纯Swift实现的方法无法被Runtime识别为可响应的action：

    // 错误写法：缺少@objc标记，selector无法匹配
    func addTap(_ sender: UIBarButtonItem) {
      print("按钮点击触发")
    }
    
    // 正确写法
    @objc func addTap(_ sender: UIBarButtonItem) {
      print("按钮点击触发")
    }
    

  • 方法的作用域错误，比如把addTap定义在控制器的私有嵌套结构体/枚举内部，不属于控制器的实例方法，绑定后系统无法定位到对应的方法实现。
• 触摸事件被其他视图拦截
  屏幕上可见的Add按钮实际处于交互链的下层，触摸事件根本无法传递到按钮本身：
  • 自定义导航栏布局时，添加的透明全屏视图刚好覆盖了导航栏按钮的点击区域，所有触摸事件被这个透明视图截获
  • 错误将导航栏、其父容器视图的isUserInteractionEnabled设为false，直接阻断了整个区域的交互能力
  • SwiftUI嵌套UIKit的场景中，UIHostingController的额外布局层吞掉了导航栏区域的触摸事件。
• 按钮实例被错误覆盖
  你在屏幕上看到的Add按钮，和之前绑定了addTap方法的按钮并非同一个实例：
  • 控制器生命周期执行顺序问题：先在viewDidLoad中正确初始化了带事件绑定的Add按钮，后续在viewWillAppear等生命周期方法中，重新给navigationItem.rightBarButtonItem赋值了一个未绑定事件的新Add按钮，覆盖了之前配置正确的按钮
  • 导航栈跳转时，当前屏幕实际显示的控制器并非你添加调试print代码的那个控制器实例，你写在旧实例里的addTap方法永远不会被触发。

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