如何从登录页跳转至UIPageViewController？跳转后黑屏问题求助

看起来你遇到的黑屏问题大概率是UIPageViewController的核心配置没做对——比如没设置数据源、没添加初始页面，或者pages数组是空的。我来帮你一步步解决这个问题：

1. 完善TutorialPageViewController的实现 #

你需要确保这个页面控制器实现UIPageViewControllerDataSource协议，并且正确初始化页面数组、设置初始显示内容：

import UIKit

class TutorialPageViewController: UIPageViewController, UIPageViewControllerDataSource {
    // 存储教程页面的数组
    var pages: [UIViewController] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 1. 绑定数据源（必须步骤，否则无法加载页面）
        dataSource = self
        
        // 2. 初始化教程页面（这里假设你通过Storyboard创建了两个教程页，记得给它们设置Storyboard ID）
        guard let page1 = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "TutorialPage1") as? UIViewController,
              let page2 = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "TutorialPage2") as? UIViewController else {
            print("教程页面初始化失败")
            return
        }
        pages = [page1, page2]
        
        // 3. 设置初始显示的第一个页面（必须步骤，否则控制器无内容）
        if let firstPage = pages.first {
            setViewControllers([firstPage], direction: .forward, animated: true, completion: nil)
        }
        
        // 可选：配置页面指示器样式
        let pageControl = UIPageControl.appearance()
        pageControl.currentPageIndicatorTintColor = .systemBlue
        pageControl.pageIndicatorTintColor = .systemGray3
    }
    
    // MARK: - UIPageViewControllerDataSource 协议实现
    func pageViewController(_ pageViewController: UIPageViewController, viewControllerBefore viewController: UIViewController) -> UIViewController? {
        guard let currentIndex = pages.firstIndex(of: viewController) else { return nil }
        return currentIndex > 0 ? pages[currentIndex - 1] : nil
    }
    
    func pageViewController(_ pageViewController: UIPageViewController, viewControllerAfter viewController: UIViewController) -> UIViewController? {
        guard let currentIndex = pages.firstIndex(of: viewController) else { return nil }
        return currentIndex < pages.count - 1 ? pages[currentIndex + 1] : nil
    }
    
    // 可选：设置页面指示器的总页数
    func presentationCount(for pageViewController: UIPageViewController) -> Int {
        return pages.count
    }
    
    // 可选：设置页面指示器默认选中的索引
    func presentationIndex(for pageViewController: UIPageViewController) -> Int {
        return 0
    }
}

2. 确认登录后的跳转逻辑正确 #

登录验证通过后，要正确实例化并跳转到教程页面控制器，避免导航栈配置错误：

// 登录验证成功后的处理代码示例
func handleLoginSuccess() {
    // 方式1：如果需要保留登录页的返回入口，用导航控制器push
    let tutorialVC = TutorialPageViewController(transitionStyle: .scroll, navigationOrientation: .horizontal)
    navigationController?.pushViewController(tutorialVC, animated: true)
    
    // 方式2：如果登录后不需要返回登录页，直接设置为根控制器
    let tutorialVC = TutorialPageViewController(transitionStyle: .scroll, navigationOrientation: .horizontal)
    let rootNav = UINavigationController(rootViewController: tutorialVC)
    if let window = UIApplication.shared.connectedScenes.first?.delegate as? SceneDelegate {
        window.window?.rootViewController = rootNav
        window.window?.makeKeyAndVisible()
    }
}

3. 排查常见的黑屏坑点 #

• pages数组为空：检查教程页面的初始化逻辑，确保没有实例化失败的情况（比如Storyboard ID写错）。
• 未设置dataSource：UIPageViewController必须绑定数据源才能加载前后页面，缺失这一步会导致控制器无内容。
• 未设置初始页面：如果没调用setViewControllers(_:direction:animated:completion:)，控制器没有默认显示的内容，自然黑屏。
• 初始化参数缺失：创建TutorialPageViewController时必须指定transitionStyle和navigationOrientation，否则会导致布局异常。

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