为UINavigationBar添加自定义返回按钮无效问题

我之前也碰到过一模一样的坑！能看到自定义返回按钮的图片，但点了完全没反应，大概率是这几个常见问题，给你整理了具体的解决步骤：

1. 别搞错了返回按钮的赋值对象 #

很多人会直接修改navigationItem.backBarButtonItem，但这个属性其实是给下一个页面显示的返回按钮用的！正确的做法是给当前页面的navigationItem.leftBarButtonItem赋值自定义按钮，并且手动绑定返回动作：

// Swift 示例
let backButton = UIButton(type: .custom)
backButton.setImage(UIImage(named: "your_back_icon"), for: .normal)
backButton.addTarget(self, action: #selector(backButtonTapped), for: .touchUpInside)
backButton.frame = CGRect(x: 0, y: 0, width: 44, height: 44) // 必须设置足够的点击区域！
navigationItem.leftBarButtonItem = UIBarButtonItem(customView: backButton)

@objc private func backButtonTapped() {
    navigationController?.popViewController(animated: true)
}

// Objective-C 示例
UIButton *backButton = [UIButton buttonWithType:UIButtonTypeCustom];
[backButton setImage:[UIImage imageNamed:@"your_back_icon"] forState:UIControlStateNormal];
[backButton addTarget:self action:@selector(backButtonTapped:) forControlEvents:UIControlEventTouchUpInside];
backButton.frame = CGRectMake(0, 0, 44, 44);
self.navigationItem.leftBarButtonItem = [[UIBarButtonItem alloc] initWithCustomView:backButton];

- (void)backButtonTapped:(id)sender {
    [self.navigationController popViewControllerAnimated:YES];
}

2. 检查点击区域是否达标 #

这是最容易忽略的点！如果自定义按钮的frame太小（比如只设置了图片的尺寸），就会导致用户点击不到。iOS的标准可点击区域是44x44，哪怕你的返回图标很小，也要给按钮设置至少这么大的frame，确保点击范围足够。

3. 确认用户交互没有被禁用 #

如果你是用UIImageView直接做按钮，一定要记得打开它的用户交互开关——UIImageView默认是关闭的：

// Swift 示例：用UIImageView做按钮的情况
let backImageView = UIImageView(image: UIImage(named: "your_back_icon"))
backImageView.isUserInteractionEnabled = true // 必须开启！
let tapGesture = UITapGestureRecognizer(target: self, action: #selector(backButtonTapped))
backImageView.addGestureRecognizer(tapGesture)
navigationItem.leftBarButtonItem = UIBarButtonItem(customView: backImageView)

另外也要检查按钮的父视图有没有设置isUserInteractionEnabled = false，避免交互被上层视图阻断。

4. 修复可能的侧滑手势冲突（可选） #

如果你的自定义返回按钮能正常点击，但系统的侧滑返回手势失效了，可以在设置完自定义按钮后，重新绑定手势代理：

// Swift 示例
navigationController?.interactivePopGestureRecognizer?.delegate = self

// 记得遵守UIGestureRecognizerDelegate协议
extension YourViewController: UIGestureRecognizerDelegate {
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        return true
    }
}

按照上面的步骤排查，应该就能解决按钮无响应的问题啦！

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