Swift：UIPageViewController左右点击切换页面致底部按钮响应异常

我太懂这种按钮被“抢”点击的糟心了——UIPageViewController默认的左右点击/滑动手势会悄悄占据屏幕边缘区域，你的Next按钮在右下角，刚好大概率落在它的触发范围内。既然你试过常规方案没用，那试试这几个针对性的解决办法：

方案1：缩小默认手势的触发范围（保留部分切换功能） #

这个方案既能保留屏幕左右侧的切换手势，又能让你的Next按钮正常接收点击。核心思路是给UIPageViewController的手势识别器设置代理，在手势触发前判断点击位置是否在按钮区域外，或者直接限制手势只在指定区域生效。

步骤： #

1. 找到UIPageViewController的所有手势识别器，设置代理：

// 假设pageVC是你的UIPageViewController实例
for gesture in pageVC.gestureRecognizers ?? [] {
    if gesture is UITapGestureRecognizer || gesture is UIPanGestureRecognizer {
        gesture.delegate = self
    }
}

2. 实现UIGestureRecognizerDelegate的gestureRecognizerShouldBegin方法：

extension YourViewController: UIGestureRecognizerDelegate {
    func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
        let touchLocation = gestureRecognizer.location(in: self.view)
        
        // 方式一：判断点击是否在Next按钮范围内，是则阻止手势触发
        if self.nextButton.frame.contains(touchLocation) {
            return false
        }
        
        // 方式二：只允许屏幕左右各100pt的区域触发切换手势（可根据需求调整数值）
        let screenWidth = UIScreen.main.bounds.width
        return touchLocation.x < 100 || touchLocation.x > screenWidth - 100
    }
}

方案2：完全禁用默认手势（彻底避免拦截） #

如果你的场景不需要通过左右点击/滑动切换页面，直接移除UIPageViewController的所有默认手势，完全手动控制页面切换即可。

代码实现： #

// 移除所有默认手势识别器
pageVC.gestureRecognizers?.forEach { pageVC.removeGestureRecognizer($0) }

// 给Next按钮添加点击事件，手动切换页面
@objc private func nextButtonTapped() {
    guard let currentVC = pageVC.viewControllers?.first else { return }
    guard let nextVC = pageVC.dataSource?.pageViewController(pageVC, viewControllerAfter: currentVC) else { return }
    
    pageVC.setViewControllers([nextVC], direction: .forward, animated: true, completion: nil)
}

方案3：调整手势优先级（解决手势冲突） #

如果上面两种方案都无效，可能是手势优先级的问题——UIPageViewController的手势优先级比按钮的触摸事件高。可以通过以下方式提升按钮的事件优先级：

// 确保按钮允许交互
nextButton.isUserInteractionEnabled = true

// 让按钮的触摸事件不被手势拦截
nextButton.gestureRecognizers?.forEach { $0.cancelsTouchesInView = false }

// 给页面控制器的手势添加延迟，让按钮事件先响应
for gesture in pageVC.gestureRecognizers ?? [] {
    gesture.delaysTouchesBegan = true
}

注意事项： #

• 如果你是用SwiftUI包装UIPageViewController（通过UIViewControllerRepresentable），需要在makeUIViewController方法里完成手势代理的设置或手势移除操作。
• 测试时可以打印手势的类型和触发位置，确认是否是目标手势在拦截点击。

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