iOS登录后切换根控制器导致视图被状态栏遮挡问题求助

问题原因分析&解决办法 #

嘿，我来帮你拆解这个问题，核心原因主要有这几点：

1. 登录跳转时的代码存在错误

你设置根控制器的代码里多了一层.window：

// 错误代码
UIApplication.shared.keyWindow?.window?.rootViewController = ...

keyWindow本身就是UIWindow实例，不需要再取.window，这会导致你实际没有正确设置根控制器（或者设置到了错误的对象上），LoginScreen可能还留在视图层级里，干扰了keyWindow的布局参数。

修复方式：
改成正确的窗口获取与根控制器设置逻辑，iOS 13+需适配多场景：

// iOS 12及以下写法
if let window = UIApplication.shared.keyWindow {
    window.rootViewController = self.storyboard?.instantiateViewController(withIdentifier: "HomeScreen")
    window.makeKeyAndVisible()
}

// iOS 13+ 推荐写法
if let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
   let window = scene.windows.first {
    window.rootViewController = self.storyboard?.instantiateViewController(withIdentifier: "HomeScreen")
    window.makeKeyAndVisible()
}

2. 两种跳转场景下的布局上下文不一致

• 从AppDelegate直接设置根控制器时，HomeScreen（导航控制器）直接挂载到window上，默认edgesForExtendedLayout = .all，视图会延伸到状态栏下方，此时keyWindow的frame包含状态栏区域，newView添加后位置正常。
• 但从LoginScreen跳转时，LoginScreen大概率是通过present方式显示的，它的布局设置（比如edgesForExtendedLayout = .none）会影响后续window的safeAreaInsets，导致HomeScreen挂载后，keyWindow的有效布局区域被压缩，newView位置计算出错被状态栏遮挡。

修复方式：
在HomeScreen对应的导航控制器的viewDidLoad里强制设置布局延伸属性：

override func viewDidLoad() {
    super.viewDidLoad()
    self.edgesForExtendedLayout = .all // 允许视图延伸到状态栏下方
    self.navigationBar.isTranslucent = true // 保持导航栏半透明，配合延伸布局
}

3. 直接操作keyWindow的方式不可靠

iOS 13+多场景适配下，keyWindow的获取和状态可能变化，直接把newView添加到keyWindow上很容易出现布局适配问题。更稳妥的方式是把newView添加到当前顶层ViewController的视图上，自动适配安全区域。

优化方式：
先添加一个获取顶层ViewController的扩展：

extension UIApplication {
    func topViewController(controller: UIViewController? = UIApplication.shared.keyWindow?.rootViewController) -> UIViewController? {
        if let nav = controller as? UINavigationController {
            return topViewController(controller: nav.visibleViewController)
        }
        if let tab = controller as? UITabBarController {
            if let selected = tab.selectedViewController {
                return topViewController(controller: selected)
            }
        }
        if let presented = controller?.presentedViewController {
            return topViewController(controller: presented)
        }
        return controller
    }
}

然后修改添加newView的代码：

if let topVC = UIApplication.shared.topViewController() {
    topVC.view.addSubview(newView!)
    // 设置约束，确保newView顶部对齐顶层视图的顶部（包含状态栏区域）
    newView?.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        newView!.topAnchor.constraint(equalTo: topVC.view.topAnchor),
        newView!.leadingAnchor.constraint(equalTo: topVC.view.leadingAnchor),
        newView!.trailingAnchor.constraint(equalTo: topVC.view.trailingAnchor),
        newView!.heightAnchor.constraint(equalToConstant: 200) // 根据你的需求调整高度
    ])
}

4. 登录跳转的流程逻辑问题

如果LoginScreen是通过present弹出的，建议先dismiss再设置根控制器，避免视图层级残留：

// 登录完成后的处理逻辑
self.dismiss(animated: true) {
    // 在这里设置根控制器
    if let scene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
       let window = scene.windows.first {
        window.rootViewController = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "HomeScreen")
        window.makeKeyAndVisible()
    }
}

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