AlertController呈现报错：视图不在窗口层级，求问题原因

这个报错我太熟了，几乎每个iOS开发者刚开始处理弹窗时都踩过这个坑！结合你给出的代码和场景，咱们一步步拆解问题出在哪，以及怎么解决。

报错本质先搞懂 #

这个错误的核心是：你用来present弹窗的AccountViewController（也就是你传的self），它的view此时还没有被添加到应用的窗口层级（window hierarchy）中。 iOS要求弹窗的presenter必须是当前已经在窗口上显示的VC，否则系统找不到正确的上下文来展示弹窗。

结合你的场景分析触发点 #

你是通过segue从RootVC跳转到AccountVC的，大概率是在AccountVC的**viewDidLoad**方法里调用了myController.alert.presentAlert(...)？

viewDidLoad只是VC加载完自身视图的回调，这时候视图还没被添加到窗口的显示栈里，相当于这个VC还没“真正出现在屏幕上”，这时候调用present自然会触发层级错误。你之前的应用没问题，估计是之前把弹窗调用放在了viewDidAppear这类VC完全显示后的回调里。

具体解决办法 #

方法1：延迟到VC完全显示后再弹窗 #

把调用弹窗的代码从viewDidLoad移到viewDidAppear(_:)方法里，这个方法会在VC的view完全添加到窗口并显示后才执行：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 这里调用弹窗就安全了
    myController.alert.presentAlert("No Agent", "You have not registered an agent yet.", self)
}

小提醒：如果只需要第一次进入VC时弹窗，可以加个布尔标记变量控制，避免每次进入都弹。

方法2：用顶层VC作为presenter（更稳健） #

如果你的弹窗可能在异步场景下调用（比如网络请求回调），即使在viewDidAppear里也可能踩坑。这时候可以给你的AlertManager加个获取当前应用顶层VC的方法，直接用顶层VC来present弹窗：

extension AlertManager {
    // 获取当前显示的顶层VC
    private func getTopViewController() -> UIViewController? {
        guard let keyWindow = UIApplication.shared.windows.first(where: { $0.isKeyWindow }) else {
            return nil
        }
        var topVC = keyWindow.rootViewController
        // 递归找到最上层的presentVC
        while let presentedVC = topVC?.presentedViewController {
            topVC = presentedVC
        }
        return topVC
    }
    
    // 重载一个不需要传presenter的弹窗方法
    func presentAlert(_ title: String, _ message: String) {
        guard let topVC = getTopViewController() else { return }
        let myAlert = UIAlertController(title: title, message: message, preferredStyle: .alert)
        let okAction = UIAlertAction(title: "OK", style: .default, handler: nil)
        myAlert.addAction(okAction)
        topVC.present(myAlert, animated: true, completion: nil)
    }
}

之后在AccountVC里调用就不用传self了：

myController.alert.presentAlert("No Agent", "You have not registered an agent yet.")

这种方式不管你在什么时机调用，都能找到当前真正显示在屏幕上的VC，彻底规避层级问题。

额外排查点 #

• 确保你的segue跳转逻辑正常，AccountVC确实被正确push/present到导航栈中；
• 如果是在异步回调里调用弹窗，一定要确保回调在主线程执行！UI操作必须在主线程，否则也可能导致奇怪的层级问题：

// 比如网络请求回调里要包一层主线程
DispatchQueue.main.async {
    myController.alert.presentAlert("No Agent", "You have not registered an agent yet.", self)
}

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