SwiftUI生命周期中动态修改状态栏样式时更换rootViewController引发外观过渡不平衡错误的解决方法

问题根源 #

你遇到的这个错误，本质是因为在StatusBarControllerView的onAppear方法里直接替换rootViewController时，系统正在处理原默认HostingController的外观过渡流程（beginAppearanceTransition还没完成），突然替换控制器就会导致begin和end调用不匹配，触发这个警告。

解决方案思路 #

我们需要避免在视图生命周期中动态替换根控制器，而是从App启动时就使用自定义的HostingController作为根，同时用SwiftUI的状态管理（环境对象+ObservableObject）来维护状态栏样式的层级，这样既满足动态修改的需求，又不会干扰系统的视图过渡流程。

修改后的完整代码 #

1. 状态栏样式管理器（ObservableObject）

首先创建一个可观察的管理器，用来维护状态栏样式的层级，并且自动通知HostingController更新状态栏：

import SwiftUI
import Combine

class StatusBarStyleManager: ObservableObject {
    @Published private(set) var styleHierarchy: [UIStatusBarStyle] = []
    let defaultStyle: UIStatusBarStyle = .lightContent
    
    func pushStyle(_ style: UIStatusBarStyle) {
        styleHierarchy.append(style)
    }
    
    func popStyle() {
        if !styleHierarchy.isEmpty {
            styleHierarchy.removeLast()
        }
    }
    
    var currentStyle: UIStatusBarStyle {
        styleHierarchy.last ?? defaultStyle
    }
}

2. 自定义HostingController

修改自定义HostingController，让它监听样式管理器的变化，自动更新状态栏：

private class StatusBarHostingController<Content: View>: UIHostingController<Content> {
    private var styleManager: StatusBarStyleManager
    private var cancellables = Set<AnyCancellable>()
    
    init(rootView: Content, styleManager: StatusBarStyleManager) {
        self.styleManager = styleManager
        super.init(rootView: rootView)
        
        // 监听样式变化，自动触发状态栏更新
        styleManager.objectWillChange.sink { [weak self] _ in
            self?.setNeedsStatusBarAppearanceUpdate()
        }.store(in: &cancellables)
    }
    
    required init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override var preferredStatusBarStyle: UIStatusBarStyle {
        styleManager.currentStyle
    }
}

3. View扩展：添加状态栏样式修改方法

通过环境对象来操作样式管理器，替代原来直接操作UIApplication静态变量的方式：

extension View {
    func statusBar(style: UIStatusBarStyle) -> some View {
        self
            .onAppear {
                // 视图出现时推送新样式
                let styleManager = EnvironmentValues._statusBarStyleManager
                styleManager.pushStyle(style)
            }
            .onDisappear {
                // 视图消失时弹出样式，恢复之前的状态
                let styleManager = EnvironmentValues._statusBarStyleManager
                styleManager.popStyle()
            }
    }
}

// 为环境值添加状态栏样式管理器的访问入口
private extension EnvironmentValues {
    static var _statusBarStyleManager: StatusBarStyleManager {
        struct Static {
            static let manager = StatusBarStyleManager()
        }
        return Static.manager
    }
}

4. App结构体配置

直接在App启动时使用自定义的HostingController作为根，不再需要原来的StatusBarControllerView：

@main
struct App: SwiftUI.App {
    private let styleManager = StatusBarStyleManager()
    
    var body: some Scene {
        WindowGroup {
            // 根视图包裹环境对象，让所有子视图都能访问样式管理器
            ContentView()
                .environmentObject(styleManager)
                .onAppear {
                    // 获取当前窗口，设置自定义HostingController为根
                    if let window = UIApplication.shared.windows.first {
                        let hostingController = StatusBarHostingController(
                            rootView: ContentView().environmentObject(styleManager),
                            styleManager: styleManager
                        )
                        window.rootViewController = hostingController
                    }
                }
        }
    }
}

// 示例根视图
struct ContentView: View {
    var body: some View {
        NavigationStack {
            NavigationLink("Go to MyView") {
                MyView()
            }
            .navigationTitle("Home")
            .statusBar(style: .lightContent) // 设置首页状态栏样式
        }
    }
}

// 示例子视图，动态修改状态栏样式
struct MyView: View {
    var body: some View {
        Text("This is MyView")
            .navigationTitle("My View")
            .statusBar(style: .darkContent) // 设置当前视图的状态栏样式
    }
}

为什么这样能解决错误？ #

1. 不再动态替换根控制器：我们在App的根视图onAppear时设置自定义HostingController，此时系统的初始视图过渡流程已经完成，不会出现begin/end不匹配的问题。
2. 使用SwiftUI原生状态管理：通过ObservableObject和环境对象来维护样式层级，替代原来直接操作UIApplication静态变量的方式，更符合SwiftUI的设计理念，也避免了跨层级的状态操作带来的潜在问题。
3. 自动触发状态栏更新：通过监听样式管理器的变化，自定义HostingController会自动调用setNeedsStatusBarAppearanceUpdate()，不需要手动触发，逻辑更清晰。

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