交互式关闭弹窗与UIScrollView手势冲突该如何解决？

问题现象 #

当关闭拖拽关闭弹窗功能时，UIScrollView运行完全正常；一旦开启拖拽关闭功能，拖动UITableView时无法正常滚动，反而会将弹窗向下拖拽。当前使用的是BottomPopup库。

问题原因 #

冲突的核心是两种拖动手势的识别优先级问题：

• BottomPopup库为了实现拖拽关闭，会在弹窗视图上添加UIPanGestureRecognizer拖动手势
• UITableView自带的滚动手势本质也是UIPanGestureRecognizer，两种手势未设置互斥规则时，系统会优先响应层级更靠上的弹窗拖动手势，导致列表滚动被拦截。

修复方案 #

可根据实际需求选择以下任意方案实现：

方案1：调整手势识别优先级 （最推荐，改造成本最低） #

在弹窗初始化或者列表加载完成的位置，添加代码要求弹窗的拖拽手势必须在列表滚动手势识别失败后才触发：

// Swift版本实现
if let popupPanGesture = bottomPopupVC.view.gestureRecognizers?.first(where: { $0 is UIPanGestureRecognizer }) {
    tableView.panGestureRecognizer.require(toFail: popupPanGesture)
}

// Objective-C版本实现
UIPanGestureRecognizer *popupPan = nil;
for (UIGestureRecognizer *gesture in bottomPopupVc.view.gestureRecognizers) {
    if ([gesture isKindOfClass:[UIPanGestureRecognizer class]]) {
        popupPan = (UIPanGestureRecognizer *)gesture;
        break;
    }
}
if (popupPan) {
    [self.tableView.panGestureRecognizer requireGestureRecognizerToFail:popupPan];
}

方案2：实现手势代理控制共存逻辑 （体验最优） #

实现UIGestureRecognizerDelegate的gestureRecognizer:shouldRecognizeSimultaneouslyWithGestureRecognizer:方法，按需控制两种手势的响应时机，可以做到列表滑到顶部后再往下拖才触发弹窗关闭，符合常规交互逻辑：

func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
    // 仅当列表已经滑到最顶部时，才允许触发弹窗的拖拽关闭手势
    if gestureRecognizer == tableView.panGestureRecognizer && otherGestureRecognizer == popupPanGesture {
        return tableView.contentOffset.y <= 0
    }
    return false
}

方案3：修改弹窗拖拽手势触发阈值 #

直接调整BottomPopup内部拖拽手势的触发条件，比如要求竖向拖动超过15pt才响应弹窗关闭逻辑，避免短距离滑动被误识别为弹窗拖动：

popupPanGesture.minimumNumberOfTouches = 1
popupPanGesture.maximumNumberOfTouches = 1
// 拖动判断逻辑增加阈值校验
let translationY = popupPanGesture.translation(in: popupView).y
if translationY > 15 {
    // 执行弹窗关闭逻辑
}

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