如何解决iOS APP删除并重新安装后打开出现黑屏的问题

• Keychain数据残留：iOS系统中APP卸载时，存储在Keychain内的数据不会被同步清除，重装后AuthManager.shared.isSignedIn会读取到旧的登录态标识，判断为已登录后直接初始化TabBarViewController。如果TabBarViewController的子控制器配置依赖登录成功后返回的用户数据，重装后本地无对应数据就会出现无内容的空白标签栏+黑页。
• 默认Storyboard配置未移除：如果Info.plist中仍保留Application Scene Manifest > Scene Configuration > Application Session Role > Item 0 > Storyboard name为Main的配置，系统会优先加载Storyboard默认的初始控制器，你在SceneDelegate中手动创建window的逻辑会被覆盖，甚至出现window冲突，导致打印日志未触发、自定义rootViewController不生效。
• 登录状态判断逻辑异常：如果AuthManager的isSignedIn属性没有设置明确默认值，或读取登录态的逻辑为异步执行，在scene(_:willConnectTo:options:)同步执行判断时，isSignedIn还未完成初始化，导致分支判断异常。
• 低版本系统兼容缺失：如果项目兼容iOS12及以下版本，低版本系统不会调用SceneDelegate的生命周期方法，只会走AppDelegate的逻辑，此时你只在SceneDelegate写的跳转代码完全不执行，就会加载默认的空控制器。

1. 修正登录态判断逻辑
   确保AuthManager的isSignedIn为非可选Bool类型，默认值为false，读取Keychain失败/无数据时统一返回false：

// AuthManager 相关代码修正
var isSignedIn: Bool {
    // 读取Keychain中存储的登录凭证
    guard let token = KeychainHelper.shared.getValue(forKey: "user_token") else {
        return false
    }
    return !token.isEmpty
}

如果需要处理设备锁屏未解锁时Keychain无法读取的场景，读取失败时统一返回false走登录页即可。

2. 移除默认Storyboard配置
   打开项目的Info.plist，找到Application Scene Manifest -> Scene Configuration -> Application Session Role -> Item 0，删除其中的Storyboard name字段，确保系统完全走SceneDelegate中手动创建window的逻辑。

3. 添加TabBar兜底逻辑
   在TabBarViewController的viewDidLoad中添加子控制器校验，避免空TabBar显示：

class TabBarViewController: UITabBarController {
    override func viewDidLoad() {
        super.viewDidLoad()
        // 子控制器为空时自动跳转登录页
        if viewControllers?.isEmpty ?? true {
            let signInNav = UINavigationController(rootViewController: SignInViewController())
            UIApplication.shared.windows.first?.rootViewController = signInNav
        }
    }
}

4. 处理卸载残留数据
   在APP首次启动时主动清空Keychain残留的旧数据，避免重装后读取到无效登录态：

// 在AppDelegate或AuthManager初始化时执行
if !UserDefaults.standard.bool(forKey: "has_launched_before") {
    KeychainHelper.shared.clearAll()
    UserDefaults.standard.set(true, forKey: "has_launched_before")
}

5. 兼容低版本系统
   如果项目支持iOS12及以下版本，需要在AppDelegate的application(_:didFinishLaunchingWithOptions:)方法中添加和SceneDelegate完全一致的rootViewController切换逻辑。

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