使用SwiftUI封装UIPageViewController时连续显示同一页面问题求助

核心问题分析 #

中等速度滑动时的页面重复显示，本质是SwiftUI状态与UIPageViewController内部页面索引不同步，加上滑动过程中代理方法的中间状态被错误处理导致的。慢滑时过渡完成状态明确，快滑时系统直接跳过中间状态，只有中等速度滑动时，过渡未完全完成的状态被错误同步到SwiftUI，引发重复渲染。

具体修复方案 #

1. 严格过滤过渡完成状态的索引更新

在UIPageViewControllerDelegate的didFinishAnimating方法中，仅当transitionCompleted为true时才更新SwiftUI的页面索引状态，忽略过渡未完成的中间回调：

func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
    guard completed, let currentVC = pageViewController.viewControllers?.first, let index = viewControllers.firstIndex(of: currentVC) else {
        return
    }
    // 确保在主线程更新SwiftUI状态
    DispatchQueue.main.async {
        self.currentPage = index
    }
}

2. 确保页面控制器的复用逻辑正确

避免在viewControllerBefore/viewControllerAfter中重复创建新的UIViewController，提前缓存所有页面VC或按需复用，防止滑动过程中VC实例混乱：

private func viewController(for index: Int) -> UIViewController {
    // 复用已创建的VC，避免重复初始化
    if index < viewControllers.count {
        return viewControllers[index]
    }
    let vc = UIHostingController(rootView: HeavyPageView(index: index))
    viewControllers.append(vc)
    return vc
}

func pageViewController(_ pageViewController: UIPageViewController, viewControllerBefore viewController: UIViewController) -> UIViewController? {
    guard let index = viewControllers.firstIndex(of: viewController), index > 0 else {
        return nil
    }
    return viewController(for: index - 1)
}

func pageViewController(_ pageViewController: UIPageViewController, viewControllerAfter viewController: UIViewController) -> UIViewController? {
    guard let index = viewControllers.firstIndex(of: viewController), index < totalPages - 1 else {
        return nil
    }
    return viewController(for: index + 1)
}

3. 调整滚动视图减速行为（兜底方案）

如果前两种方案仍有问题，可尝试修改滚动视图的减速速率，减少中等速度滑动时的过渡中间状态：

// 在UIPageViewController初始化完成后设置
pageViewController.scrollView?.decelerationRate = .fast

关键注意点 #

• 所有SwiftUI状态更新必须在主线程执行，UIKit代理方法本身在主线程，但异步包裹能避免极端情况下的线程冲突。
• 不要依赖UIPageViewController的viewControllers属性实时获取当前页面，必须通过didFinishAnimating的回调确认过渡完成后再同步状态。

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