重复推送同类型ViewController启用动画致UI冻结，求解决方案

我之前也碰到过一模一样的问题，那个快照错误提示确实挺烦人的，还直接搞崩了导航动画的体验。咱们来拆解问题，一步步解决：

问题根源 #

你看到的"[Snapshotting] Snapshotting a view that has not been rendered at least once requires afterScreenUpdates:YES."错误，核心原因是：系统在执行导航推送动画时，需要对即将展示的ViewController的视图生成快照，但这个视图还没完成第一次渲染。这种情况下，系统的快照逻辑会卡住主线程，最终导致UI冻结。

可行的解决方案 #

1. 提前渲染目标ViewController的视图 #

最简单直接的办法，就是在推送之前，强制让目标VC的视图完成第一次加载和渲染。这样系统做快照的时候，视图已经准备好了，就不会报错了。

代码示例：

// 创建目标VC实例
let productController = ProductController()
// 强制加载并渲染视图（主线程执行）
DispatchQueue.main.async {
    productController.loadViewIfNeeded()
    self.navigationController?.pushViewController(productController, animated: true)
}

解释：loadViewIfNeeded()会触发VC的loadView和viewDidLoad方法，完成视图的初始化和第一次渲染，确保系统快照时视图已经处于可用状态。

2. 排查主线程耗时操作 #

有时候UI冻结不完全是快照的锅，可能是你在目标VC的viewDidLoad、viewWillAppear里做了耗时操作（比如同步网络请求、大量数据解析、复杂UI布局计算），这些操作占用了主线程，和导航动画抢资源，导致界面卡住。

解决思路：把所有非UI的耗时操作移到后台线程，完成后再切回主线程更新UI。比如：

override func viewDidLoad() {
    super.viewDidLoad()
    // 耗时操作丢到后台队列
    DispatchQueue.global(qos: .userInitiated).async {
        // 示例：加载商品数据
        let productData = self.fetchProductDetails()
        // 回到主线程更新UI
        DispatchQueue.main.async {
            self.productNameLabel.text = productData.name
            self.productPriceLabel.text = productData.price
        }
    }
}

3. 自定义导航过渡动画（进阶方案） #

如果前两种方法都没解决问题，可以考虑绕过系统默认的快照逻辑，自定义导航过渡动画。你需要实现UINavigationControllerDelegate的相关方法，自己控制动画过程：

// 在当前VC里设置导航代理
self.navigationController?.delegate = self

// 实现代理方法，返回自定义动画控制器
extension YourCurrentController: UINavigationControllerDelegate {
    func navigationController(_ navigationController: UINavigationController, animationControllerFor operation: UINavigationController.Operation, from fromVC: UIViewController, to toVC: UIViewController) -> UIViewControllerAnimatedTransitioning? {
        if operation == .push {
            return CustomPushAnimator()
        }
        return nil
    }
}

// 自定义动画控制器
class CustomPushAnimator: NSObject, UIViewControllerAnimatedTransitioning {
    func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval {
        return 0.35 // 和系统默认动画时长一致
    }
    
    func animateTransition(using transitionContext: UIViewControllerContextTransitioning) {
        guard let toVC = transitionContext.viewController(forKey: .to) else { return }
        let containerView = transitionContext.containerView
        
        // 设置初始位置（从右侧滑入）
        toVC.view.frame = CGRect(x: containerView.bounds.width, y: 0, width: containerView.bounds.width, height: containerView.bounds.height)
        containerView.addSubview(toVC.view)
        
        // 执行动画
        UIView.animate(withDuration: transitionDuration(using: transitionContext), animations: {
            toVC.view.frame = containerView.bounds
        }) { _ in
            transitionContext.completeTransition(!transitionContext.transitionWasCancelled)
        }
    }
}

这个方法完全绕过了系统的快照逻辑，自己控制视图的过渡动画，从根源上避免快照错误。

总结 #

优先尝试第一种方法（提前加载视图），这是成本最低、见效最快的方案；如果还有问题，检查主线程是否有耗时操作；最后再考虑自定义动画。

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