更换UIWindow的rootViewController时出现偶发性黑屏问题求助

这种偶现且仅特定设备触发的UI问题真的很磨人，我之前也碰到过类似的Storyboard相关的诡异状况，结合你的描述，给你整理几个针对性的排查方向和解决办法：

一、先搞定Storyboard的潜在损坏问题 #

你怀疑Storyboard损坏是对的，这是这类诡异黑屏/视图错乱问题的常见元凶，试试这几步：

• 清掉编译缓存重来：删掉项目的DerivedData文件夹（路径一般是~/Library/Developer/Xcode/DerivedData/你的项目名-一串随机字符），然后用Cmd+Shift+K清掉项目缓存，再重新Build。有时候旧的编译缓存会导致Storyboard的布局信息乱掉。
• 检查Storyboard的XML结构：用文本编辑器打开Onboarding.storyboard，看看里面的XML有没有标签未闭合、关键节点缺失的情况。如果发现损坏，要么从Git历史里恢复一个正常版本，要么干脆新建一个Storyboard重新做Onboarding页面。
• 确认初始ViewController标记：一定要检查Onboarding.storyboard里的初始VC有没有勾选Is Initial View Controller，这个标记有时候会莫名其妙丢失，导致instantiateInitialViewController()返回nil，window的rootViewController就空了，自然黑屏。

二、优化RootViewController的设置代码 #

你的现有代码有个隐藏风险：如果window还没被系统初始化，window?.rootViewController的赋值就会直接失效。建议调整成这样：

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // 主动初始化window，避免依赖系统延迟初始化
        self.window = UIWindow(frame: UIScreen.main.bounds)
        
        let isFirstLaunch = true // 替换成你的判断逻辑
        let targetVC: UIViewController
        
        if isFirstLaunch {
            let onboardingStoryboard = UIStoryboard(name: "Onboarding", bundle: nil)
            // 加个兜底，防止Storyboard初始化失败
            guard let onboardingVC = onboardingStoryboard.instantiateInitialViewController() else {
                let mainStoryboard = UIStoryboard(name: "Main", bundle: nil)
                targetVC = mainStoryboard.instantiateInitialViewController()!
                return true
            }
            targetVC = onboardingVC
        } else {
            let mainStoryboard = UIStoryboard(name: "Main", bundle: nil)
            targetVC = mainStoryboard.instantiateInitialViewController()!
        }
        
        window?.rootViewController = targetVC
        // 显式调用，确保window被激活显示
        window?.makeKeyAndVisible()
        
        return true
    }
}

这里的核心改进点：

• 主动初始化window，不依赖系统的自动初始化
• 加了guard做兜底，就算Onboarding的Storyboard出问题，也能 fallback 到主页面
• 显式调用makeKeyAndVisible()，确保window能正常显示

三、特定设备的排查技巧 #

如果只有某台设备出问题，大概率是设备本地的缓存或系统小异常：

• 彻底重装应用：删掉设备上的应用，重启设备后再重新安装，避免本地残留的旧Storyboard资源搞事情。
• 检查系统版本兼容性：看看出问题的设备系统版本是不是比较旧，有没有用到它不支持的Storyboard布局特性（比如某些新的Auto Layout约束、iOS16+的组件），低版本系统有时候会解析不了新的布局语法。

四、线上应用的防护方案 #

为了避免线上用户碰到同样的问题，建议做这两个防护：

• 加个启动后的检查逻辑：在applicationDidBecomeActive里检查window?.rootViewController是不是空的，如果是空的，直接切换到主页面。
• 准备代码实现的备选页面：把Onboarding页面的核心逻辑用纯代码写一份，当Storyboard初始化失败时，自动切换到代码实现的版本，确保用户不会看到黑屏。

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