模态弹出的ViewController中UIButton的touchUpInside点击事件无法触发问题

云原生阿岚

2026-9-28

问题原因及解决方案

1 原始static属性写法的根本错误

你最初将按钮声明为`static`静态属性时，初始化闭包内的`self`指向的是`NewController`类本身，而非你创建的控制器实例，而`starTapped`是实例方法，运行时无法匹配到对应实现，事件自然不会触发。即便你后续改为单例模式，静态属性绑定的target依然是类对象，该写法本身就存在逻辑错误。

2 移除static后仍无响应的排查解决路径

2.1 检查按钮属性是否用lazy修饰

如果你的按钮属性是普通let常量，初始化闭包执行时控制器实例尚未完成初始化，此时引用的self是无效的，target绑定直接失败。必须改为lazy var属性：

lazy var star: UIButton = {
    let btn = UIButton()
    // 原有按钮样式配置保持不变
    btn.addTarget(self, action: #selector(starTapped), for: .touchUpInside)
    return btn
}()

2.2 解决UIScrollView手势拦截问题

UIScrollView默认的滚动手势会在识别到滚动操作时，取消对子视图的触摸事件传递。如果点击按钮时手指有轻微移动，就会被识别为滚动操作，导致touchUpInside事件不触发。添加如下配置即可解决：

scrollView.panGestureRecognizer.cancelsTouchesInView = false

2.3 修正Popover弹出的响应范围异常

你使用了.popover模态样式，若未正确配置弹出内容尺寸，会导致NewController的view超出popover容器的可响应区域：按钮虽然视觉上可见，但点击事件不会被容器接收。可以在NewController的viewDidLoad中显式设置期望的内容尺寸：

preferredContentSize = CGSize(width: 你需要的宽度, height: 你需要的高度)

如果需要自适应内容尺寸，可以实现UIPopoverPresentationControllerDelegate的相关代理方法配置。

2.4 排查父视图的自定义手势冲突

检查按钮所在的UIScrollView或上层父视图是否添加了独立的UITapGestureRecognizer，如果有可以通过以下两种方式解决冲突：

配置手势属性：

tapGesture.cancelsTouchesInView = false

实现手势代理方法，屏蔽按钮区域的手势识别：

func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive touch: UITouch) -> Bool {
    if touch.view is UIButton {
        return false
    }
    return true
}

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