Swift 刘海屏设备修改状态栏颜色失效问题求助

先确认你有没有踩以下几个容易忽略的坑：

• 你的Info.plist中View controller-based status bar appearance配置项是否为YES，如果设为NO，所有VC级别的状态栏配置都会被系统忽略
• 如果承载WKWebView的ViewController是嵌套在UINavigationController/UITabBarController中，需要在父容器类中重写childForStatusBarStyle指向当前WebViewController，否则你重写的状态栏属性不会生效
• 你之前将自定义状态栏View添加到KeyWindow的代码执行时机过早，比如放在viewDidLoad中执行，此时Window层级还未完全初始化，添加的View很容易被后来渲染的WKWebView层级覆盖
• 如果当前ViewController是通过present方式弹出的，需要将modalPresentationCapturesStatusBarAppearance属性设为true，才会优先走当前VC的状态栏配置

方案1：原生侧单独添加状态栏背景（最稳定，无需修改网页） #

不需要修改全局Window层级，直接在当前ViewController的View中添加独立的状态栏背景View，避免被WKWebView覆盖：

class WebViewController: UIViewController {
    // 自定义状态栏背景View
    private lazy var statusBarBgView: UIView = {
        let view = UIView()
        // 替换为你需要的状态栏颜色
        view.backgroundColor = UIColor(red: 242/255, green: 242/255, blue: 242/255, alpha: 1.0)
        view.translatesAutoresizingMaskIntoConstraints = false
        return view
    }()
    
    // 如果需要修改状态栏文字颜色，重写这个属性
    override var preferredStatusBarStyle: UIStatusBarStyle {
        // 根据背景色选.darkContent（黑色文字）或.lightContent（白色文字）
        return .darkContent
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        setupStatusBarBgView()
        // 原有WKWebView初始化逻辑
        // ...
    }

    private func setupStatusBarBgView() {
        view.addSubview(statusBarBgView)
        let statusBarHeight = view.window?.windowScene?.statusBarManager?.statusBarFrame.height ?? 0
        NSLayoutConstraint.activate([
            statusBarBgView.topAnchor.constraint(equalTo: view.topAnchor),
            statusBarBgView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            statusBarBgView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            statusBarBgView.heightAnchor.constraint(equalToConstant: statusBarHeight)
        ])
        // 调整WKWebView约束，顶部对齐状态栏背景底部，避免内容被状态栏遮挡
        webView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            webView.topAnchor.constraint(equalTo: statusBarBgView.bottomAnchor),
            webView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            webView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            webView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
        ])
    }
}

如果你的VC放在导航控制器中，添加以下扩展让导航控制器优先响应子VC的状态栏配置：

extension UINavigationController {
    open override var childForStatusBarStyle: UIViewController? {
        return topViewController
    }
}

方案2：需要WKWebView内容延伸到状态栏下方的场景 #

如果业务要求网页内容铺满全屏，状态栏悬浮在网页上方，按以下步骤配置：

1. 原生侧将上述自定义statusBarBgView的背景色设为透明，根据网页背景色重写preferredStatusBarStyle调整文字颜色
2. 网页端viewport标签添加viewport-fit=cover属性：

<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">

3. 网页端通过安全区变量适配顶部间距，避免内容被状态栏遮挡：

body {
  padding-top: env(safe-area-inset-top);
}

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