iOS：自定义模态展示后保持状态栏正常显示

兄弟，我之前踩过几乎一模一样的坑！这种状态栏异常在复杂嵌套VC+自定义转场的场景下太常见了，核心问题就是系统对状态栏的归属判断和你的自定义动画逻辑冲突了，给你几个亲测有效的解决方案：

先理清楚核心原因 #

你这个场景里，进入设置时先缩小嵌套的UINavigationController再模态展示面板，系统此时还能正确识别最上层的是设置VC；但退出时，自定义的恢复动画和系统的dismiss转场重叠，导致系统误以为之前缩小的导航VC还是“活跃状态”，或者状态栏的控制权没有及时交还给主层级的VC，最终出现异常。

解决方案一：明确状态栏的控制权 #

1. 先确认Info.plist里的UIViewControllerBasedStatusBarAppearance是YES（默认就是，但最好检查下，这个是基于VC控制状态栏的前提）。
2. 在你的设置面板VC里，明确重写状态栏相关方法，把样式、可见性、动画都固定下来：

override var prefersStatusBarHidden: Bool {
    return false // 按你退出后的需求设置，比如要显示状态栏就设为false
}
override var preferredStatusBarStyle: UIStatusBarStyle {
    return .darkContent // 替换成你主界面的状态栏样式
}
override var preferredStatusBarUpdateAnimation: UIStatusBarAnimation {
    return .fade // 和你的退出动画风格匹配，避免突兀
}

3. 退出设置面板时，在dismiss的完成回调里主动触发状态栏更新，强制系统同步状态：

self.dismiss(animated: true) {
    // 两种方式选一个就行
    // 方式1：直接通知系统更新
    UIApplication.shared.setStatusBarStyle(.darkContent, animated: true)
    // 方式2：让主层级VC主动请求更新
    self.presentingViewController?.setNeedsStatusBarAppearanceUpdate()
}

解决方案二：修复模态展示的层级问题 #

你之前可能是从嵌套的导航VC里present设置面板，这会导致层级混乱。改成从最顶层的根VC来present，这样系统对层级的判断会更清晰：

// 写个工具方法获取最顶层VC
func getTopMostVC() -> UIViewController? {
    var topVC = UIApplication.shared.keyWindow?.rootViewController
    while let presentedVC = topVC?.presentedViewController {
        topVC = presentedVC
    }
    return topVC
}

// 展示设置面板时用这个方法获取的VC来present
getTopMostVC()?.present(settingsPanelVC, animated: true) {
    // 这里可以执行缩小导航VC的动画，顺序别搞反了
}

解决方案三：让容器VC正确转发状态栏请求 #

如果你的容器VC是自定义的，系统会默认询问它的状态栏设置，但它没把请求传递给嵌套的导航VC，所以要重写相关方法：

class ContainerVC: UIViewController {
    // 保存当前活跃的子VC（也就是你的嵌套导航VC）
    var activeChildVC: UIViewController?

    override var prefersStatusBarHidden: Bool {
        return activeChildVC?.prefersStatusBarHidden ?? super.prefersStatusBarHidden
    }

    override var preferredStatusBarStyle: UIStatusBarStyle {
        return activeChildVC?.preferredStatusBarStyle ?? super.preferredStatusBarStyle
    }

    // 当子VC切换或状态栏设置变化时，调用这个方法触发更新
    func refreshStatusBar() {
        setNeedsStatusBarAppearanceUpdate()
    }
}

然后在退出设置面板的回调里，调用容器VC的refreshStatusBar()方法，确保系统拿到正确的状态栏配置。

额外排查小细节 #

• 检查你自定义的缩小/恢复导航VC的动画，有没有修改过导航VC的view的alpha或者hidden属性？如果有，一定要确保退出动画完成后，导航VC的view是完全可见的，否则系统会认为它不需要显示状态栏。
• 如果用了自定义转场动画（UIViewControllerAnimatedTransitioning），要在animateTransition方法里同步处理状态栏的动画，比如退出转场时，和导航VC的恢复动画一起改变状态栏样式。

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