Swift iOS 15 应用首次启动时状态栏样式显示错误问题排查

问题根因 #

你当前的导航栏样式配置写在首屏视图控制器的viewDidLoad方法中，这个调用时机早于导航控制器被添加到keyWindow渲染层级的时间点。系统冷启动时会优先读取初始渲染阶段的导航栏配置生成状态栏，此时你的自定义配置还未被系统识别，因此会显示默认样式；切后台再返回时系统会重新读取当前生效的导航栏配置，所以样式恢复正常。

解决方案 #

方案1：在根控制器初始化阶段配置（推荐） #

在AppDelegate（无SceneDelegate的项目）或SceneDelegate的根控制器初始化节点配置导航栏样式，保证在window完成初始渲染前配置生效。
如果是使用SceneDelegate的项目，代码示例：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else { return }
    let window = UIWindow(windowScene: windowScene)
    self.window = window
    guard let navVC = window.rootViewController as? UINavigationController else { return }
    
    // 原有的导航栏配置逻辑移到此处
    navVC.navigationBar.overrideUserInterfaceStyle = .dark
    navVC.navigationBar.barStyle = .black
    let appearance = UINavigationBarAppearance()
    appearance.configureWithTransparentBackground()
    navVC.navigationBar.standardAppearance = appearance
    navVC.navigationBar.scrollEdgeAppearance = appearance
    
    window.makeKeyAndVisible()
}

如果是没有SceneDelegate的老项目，把上述逻辑移到AppDelegate的application(_:didFinishLaunchingWithOptions:)方法中即可。

方案2：首屏视图触发状态栏刷新 #

如果不想改动全局初始化逻辑，可以在首屏视图的viewWillAppear方法中主动触发状态栏刷新，添加标识保证仅首次加载时执行：

private var isFirstLoad = true

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    guard isFirstLoad else { return }
    setNeedsStatusBarAppearanceUpdate()
    isFirstLoad = false
}

内容的提问来源于stack exchange，提问作者Clément Besson