如何解决快速连续滑动时PageViewController索引追踪异常问题？

这个场景我在做无限滚动PageVC时踩过坑！快速滑动导致代理方法触发异常、索引乱掉，本质是因为UIPageViewController的过渡动画还没完成，用户就触发了下一次滑动，打断了原有流程，使得didFinishAnimating里的状态判断完全失效。下面给你两种解决方案，优先推荐第一种（优化索引逻辑），第二种是限制滑动速度（可选）。

一、修复索引追踪逻辑（推荐） #

放弃依赖willTransitionTo和didFinishAnimating传递nextIndex的方式，改为直接从当前显示的ViewController获取索引，并结合无限滚动的逻辑维护一个真实的全局索引，彻底避免代理触发不及时的问题。

核心思路： #

1. 维护一个独立的currentRealIndex变量，记录真实的页面位置（对应你数据源的总页数）
2. 在didFinishAnimating中，直接获取当前显示的ContentViewController，根据它的indexController计算真实索引的变化
3. 如果动画未完成，强制重置PageVC的显示为当前真实索引对应的VC，避免界面和索引不一致

代码示例： #

// 假设你的数据源总页数
var totalPages: Int = 5
// 真实的当前页面索引
var currentRealIndex: Int = 0

func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
    guard completed, let currentVC = pageViewController.viewControllers?.first as? ContentViewController else {
        // 动画未完成，强制重置到当前真实索引对应的VC
        let correctVC = createContentVC(for: currentRealIndex)
        pageViewController.setViewControllers([correctVC], direction: .forward, animated: false)
        return
    }
    
    // 根据你的无限滚动逻辑，映射VC的indexController到真实索引
    // 举例：如果用3个VC循环（前一个、当前、后一个），VC的indexController对应 realIndex-1, realIndex, realIndex+1
    let delta = currentVC.indexController - 1 // 中间的VC对应当前真实索引，delta为偏移量
    currentRealIndex = (currentRealIndex + delta + totalPages) % totalPages
    
    // 这里可以更新你的UI或其他业务逻辑
    print("当前真实索引：\(currentRealIndex)")
}

// 辅助方法：根据真实索引创建对应的ContentViewController
func createContentVC(for realIndex: Int) -> ContentViewController {
    let vc = ContentViewController()
    // 为无限滚动设置VC的indexController（比如循环3个：realIndex-1, realIndex, realIndex+1）
    vc.indexController = (realIndex - 1 + totalPages) % totalPages
    // 其他配置...
    return vc
}

二、禁止快速滑动（可选，影响体验） #

如果必须限制用户的快速滑动操作，可以通过控制PageVC内部ScrollView的滚动状态，在动画未完成时禁止滑动。

代码示例： #

var isTransitioning = false

override func viewDidLoad() {
    super.viewDidLoad()
    // 找到PageVC内部的ScrollView
    if let scrollView = view.subviews.first(where: { $0 is UIScrollView }) as? UIScrollView {
        scrollView.delegate = self
    }
}

// 实现UIScrollViewDelegate，控制滚动权限
extension YourPageViewController: UIScrollViewDelegate {
    func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
        if isTransitioning {
            scrollView.isScrollEnabled = false
        }
    }
    
    func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
        if !decelerate {
            isTransitioning = false
            scrollView.isScrollEnabled = true
        }
    }
    
    func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
        isTransitioning = false
        scrollView.isScrollEnabled = true
    }
}

// 在PageVC代理方法中标记过渡状态
func pageViewController(_ pageViewController: UIPageViewController, willTransitionTo pendingViewControllers: [UIViewController]) {
    isTransitioning = true
}

func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
    isTransitioning = false
    // 其他索引逻辑...
}

注意事项 #

• 无限滚动的PageVC建议只维护3个ContentViewController（前、中、后），滑动时动态替换超出视野的VC，既节省内存又能避免索引混乱
• 优先用第一种方案，限制滑动会降低用户体验，只有在业务特殊要求下再考虑

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