UIKit中上层视图仅处理指定手势，如何让下层接收其他手势？

问题场景 #

两个重叠的UIView（同属一个父视图）：

• 后方蓝色视图：绑定UITapGestureRecognizer，需响应点击事件
• 前方橙色视图：绑定UILongPressGestureRecognizer（拖拽手势同理），需响应长按事件

核心需求 #

• 触发前方视图的目标手势（长按）时，由前方视图处理
• 触发其他手势（如点击）时，事件传递给后方视图处理
• 前方视图不得拦截自身不处理的手势

遇到的问题 #

设置cancelsTouchesInView = false或使用UIGestureRecognizerDelegate的shouldReceive方法无效，因为UIKit命中测试优先选中前方视图，后方视图无法接收重叠区域的触摸事件。

示例代码 #

import SwiftUI
import UIKit

struct TestGestureConflict: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> TestGestureConflictViewController {
        TestGestureConflictViewController()
    }

    func updateUIViewController(_ uiViewController: TestGestureConflictViewController, context: Context) {}
}

final class TestGestureConflictViewController: UIViewController {
    private let tapView = UIView()
    private let longPressView = UIView()

    override func viewDidLoad() {
        super.viewDidLoad()

        view.backgroundColor = .systemBackground
        configureTapView()
        configureLongPressView()
        configureGestures()
    }

    private func configureTapView() {
        tapView.translatesAutoresizingMaskIntoConstraints = false
        tapView.backgroundColor = UIColor.systemBlue.withAlphaComponent(0.35)
        tapView.layer.borderColor = UIColor.systemBlue.cgColor
        tapView.layer.borderWidth = 2

        view.addSubview(tapView)

        NSLayoutConstraint.activate([
            tapView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            tapView.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            tapView.widthAnchor.constraint(equalToConstant: 120),
            tapView.heightAnchor.constraint(equalToConstant: 120)
        ])
    }

    private func configureLongPressView() {
        longPressView.translatesAutoresizingMaskIntoConstraints = false
        longPressView.backgroundColor = UIColor.systemOrange.withAlphaComponent(0.35)
        longPressView.layer.borderColor = UIColor.systemOrange.cgColor
        longPressView.layer.borderWidth = 2

        view.addSubview(longPressView)

        NSLayoutConstraint.activate([
            longPressView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
            longPressView.centerYAnchor.constraint(equalTo: view.centerYAnchor),
            longPressView.widthAnchor.constraint(equalToConstant: 220),
            longPressView.heightAnchor.constraint(equalToConstant: 220)
        ])
    }

    private func configureGestures() {
        let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTap))
        tapGesture.delegate = self
        tapView.addGestureRecognizer(tapGesture)

        let longPressGesture = UILongPressGestureRecognizer(target: self, action: #selector(handleLongPress))
        longPressGesture.cancelsTouchesInView = false
        longPressGesture.delegate = self
        longPressView.addGestureRecognizer(longPressGesture)
    }

    @objc private func handleTap(_ gestureRecognizer: UITapGestureRecognizer) {
        guard gestureRecognizer.state == .ended else { return }
        print("tap")
    }

    @objc private func handleLongPress(_ gestureRecognizer: UILongPressGestureRecognizer) {
        switch gestureRecognizer.state {
        case .began:
            print("long press began")

        case .ended, .cancelled:
            print("long press ended")

        default:
            break
        }
    }
}

extension TestGestureConflictViewController: UIGestureRecognizerDelegate {
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive touch: UITouch) -> Bool {
        return true
    }
}

推荐解决方案：将手势绑定到父视图，通过代理协调处理 #

这种方式无需修改视图层级或自定义hitTest，通过让父视图统一接收触摸事件，再通过代理判断手势是否应该处理当前触摸，同时允许手势协同识别，完美满足需求。

步骤1：修改手势绑定逻辑 #

将两个手势识别器绑定到父视图，而非各自的子视图：

private func configureGestures() {
    let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleTap))
    tapGesture.delegate = self
    view.addGestureRecognizer(tapGesture) // 绑定到父视图

    let longPressGesture = UILongPressGestureRecognizer(target: self, action: #selector(handleLongPress))
    longPressGesture.cancelsTouchesInView = false
    longPressGesture.delegate = self
    view.addGestureRecognizer(longPressGesture) // 绑定到父视图
}

步骤2：实现手势代理方法 #

通过代理方法判断触摸点是否属于对应视图，同时允许两个手势协同识别：

extension TestGestureConflictViewController: UIGestureRecognizerDelegate {
    // 判断手势是否应该接收当前触摸事件
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldReceive touch: UITouch) -> Bool {
        let touchPoint = touch.location(in: view)
        
        if gestureRecognizer is UITapGestureRecognizer {
            // 点击手势仅处理tapView范围内的触摸
            let pointInTapView = view.convert(touchPoint, to: tapView)
            return tapView.point(inside: pointInTapView, with: nil)
        } else if gestureRecognizer is UILongPressGestureRecognizer {
            // 长按手势仅处理longPressView范围内的触摸
            let pointInLongPressView = view.convert(touchPoint, to: longPressView)
            return longPressView.point(inside: pointInLongPressView, with: nil)
        }
        return true
    }

    // 允许两个手势同时识别，让UIKit自动协调手势优先级
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        return true
    }
}

方案原理 #

1. 父视图接收所有触摸事件，确保两个手势都能获取到触摸信息
2. shouldReceive方法过滤触摸点，确保每个手势只处理对应视图范围内的事件
3. shouldRecognizeSimultaneouslyWith允许手势协同工作：UIKit会自动处理手势冲突，比如长按触发时会取消点击手势，点击触发时长按手势不会激活，完全符合需求

其他可选方案对比 #

• 自定义hitTest/point(inside:)：需要自定义视图类，且难以处理长按这类延迟触发的手势（触摸初期无法判断是否是长按，可能导致误触发点击）
• 手动转发触摸事件：需要在前方视图的touches方法中手动转发事件，代码繁琐且容易出错
• 修改视图层级：调整视图顺序会破坏原有布局逻辑，不可取

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