UIPageViewController嵌套QLPreviewController后滚动分页失效问题求助

我之前也碰到过一模一样的场景——当UIPageViewController用.scroll过渡样式时，系统确实不会填充gestureRecognizers数组，官方文档明确说了只有.pageCurl模式才会暴露这些手势。再加上QLPreviewController本身自带了一套交互手势（比如内容滚动、缩放），很容易和UIPageViewController的分页逻辑冲突，甚至直接拦截触摸事件，导致分页完全失效。下面给你几个可行的解决思路：

思路1：手动添加自定义手势识别器 #

既然系统不给现成的手势，那我们自己加一套来控制分页。这种方法最可靠，完全符合苹果API规范，也不会有审核风险。

具体步骤： #

1. 在UIPageViewController的viewDidLoad中添加平移和滑动手势：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 添加平移手势
    let panGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture(_:)))
    panGesture.delegate = self
    view.addGestureRecognizer(panGesture)
    
    // 添加左右滑动手势
    let leftSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleSwipeGesture(_:)))
    leftSwipe.direction = .left
    leftSwipe.delegate = self
    view.addGestureRecognizer(leftSwipe)
    
    let rightSwipe = UISwipeGestureRecognizer(target: self, action: #selector(handleSwipeGesture(_:)))
    rightSwipe.direction = .right
    rightSwipe.delegate = self
    view.addGestureRecognizer(rightSwipe)
}

2. 实现手势处理逻辑，调用UIPageViewController的分页方法：

@objc private func handlePanGesture(_ gesture: UIPanGestureRecognizer) {
    guard gesture.state == .ended else { return }
    let translationX = gesture.translation(in: view).x
    
    // 根据滑动距离判断切换方向（阈值可以自己调整）
    if translationX > 60 {
        // 向右滑动，切换到上一页
        if let prevVC = dataSource?.pageViewController(self, viewControllerBefore: viewControllers?.first!) {
            setViewControllers([prevVC], direction: .reverse, animated: true, completion: nil)
        }
    } else if translationX < -60 {
        // 向左滑动，切换到下一页
        if let nextVC = dataSource?.pageViewController(self, viewControllerAfter: viewControllers?.first!) {
            setViewControllers([nextVC], direction: .forward, animated: true, completion: nil)
        }
    }
}

@objc private func handleSwipeGesture(_ gesture: UISwipeGestureRecognizer) {
    guard let currentVC = viewControllers?.first else { return }
    
    switch gesture.direction {
    case .left:
        if let nextVC = dataSource?.pageViewController(self, viewControllerAfter: currentVC) {
            setViewControllers([nextVC], direction: .forward, animated: true, completion: nil)
        }
    case .right:
        if let prevVC = dataSource?.pageViewController(self, viewControllerBefore: currentVC) {
            setViewControllers([prevVC], direction: .reverse, animated: true, completion: nil)
        }
    default:
        break
    }
}

3. 解决手势冲突：实现UIGestureRecognizerDelegate方法，允许自定义手势和QLPreviewController的手势同时识别（如果需要保留预览内容的交互）：

extension YourPageViewController: UIGestureRecognizerDelegate {
    func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
        // 允许同时识别，这样既可以分页，也能操作预览内容
        return true
    }
}

思路2：封装QLPreviewController到容器ViewController #

把QLPreviewController作为子控制器嵌入到一个普通的UIViewController中，再将这个容器VC作为UIPageViewController的子控制器。这样可以隔离QLPreviewController的事件传递，确保UIPageViewController的滚动逻辑能正常接收触摸事件。

示例代码： #

class PreviewContainerVC: UIViewController {
    private let previewController = QLPreviewController()
    private var previewItems: [QLPreviewItem] = []
    
    init(previewItems: [QLPreviewItem]) {
        self.previewItems = previewItems
        super.init(nibName: nil, bundle: nil)
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 添加QLPreviewController作为子控制器
        addChild(previewController)
        previewController.view.frame = view.bounds
        view.addSubview(previewController.view)
        previewController.didMove(toParent: self)
        
        // 设置预览数据源
        previewController.dataSource = self
        previewController.currentPreviewItemIndex = 0
    }
}

// 实现QLPreviewControllerDataSource
extension PreviewContainerVC: QLPreviewControllerDataSource {
    func numberOfPreviewItems(in controller: QLPreviewController) -> Int {
        return previewItems.count
    }
    
    func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
        return previewItems[index]
    }
}

之后你只需要把PreviewContainerVC实例作为UIPageViewController的子控制器即可，这样分页滚动和预览内容的交互都能正常工作。

思路3：禁用QLPreviewController的手势（按需使用） #

如果你的场景不需要用户和QLPreviewController的内容交互（比如只需要展示，不需要缩放、滚动预览），可以直接禁用它的所有手势：

// 在QLPreviewController加载完成后调用
previewController.view.gestureRecognizers?.forEach {
    $0.isEnabled = false
}

这种方法最简单，但会牺牲预览内容的交互性，所以只适合特定场景。

思路4：获取UIPageViewController的内部ScrollView（不推荐） #

UIPageViewController在.scroll模式下内部其实是用UIScrollView实现的，但苹果没有暴露这个ScrollView的API。你可以通过遍历子视图的方式找到它：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    
    if let scrollView = view.subviews.first(where: { $0 is UIScrollView }) as? UIScrollView {
        // 可以设置delegate或者调整交互属性
        scrollView.delegate = self
    }
}

⚠️ 注意：这种方法依赖苹果的视图层级实现，未来系统更新可能会失效，而且App Store审核有被拒绝的风险，仅建议在内部应用或紧急场景下使用。

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