Storyboard间导航异常：从非首屏进入时导航功能失效问题排查

这个问题我之前帮不少开发者排查过，核心原因其实很明确：你用present(_:animated:completion:)弹出的ViewController，并没有被嵌入到UINavigationController的导航栈中。当你在目标页面调用self.navigationController?.setNavigationBarHidden(...)时，navigationController属性其实是nil，所有导航相关的操作自然无法生效。

为什么从首屏进入没问题？因为你的首屏应该是被UINavigationController包裹作为根控制器的，它本身就在导航栈里，后续的页面跳转（比如push）也会加入这个栈，所以导航功能正常。但直接从AppDelegate实例化非首屏页面并present时，这个页面是独立存在的，不属于任何导航容器。

两种解决方案（根据你的业务场景选择） #

场景1：目标页面属于原有导航流程的一部分 #

如果你希望目标页面和首屏在同一个导航栈里，应该通过根导航控制器的pushViewController方法跳转，而不是present：

// 先获取App根窗口的导航控制器
guard let rootNav = UIApplication.shared.keyWindow?.rootViewController as? UINavigationController else {
    print("根控制器不是UINavigationController，请检查配置")
    return
}
// 实例化目标页面
let storyboard = UIStoryboard(name: "Main", bundle: nil)
let welcomeVC = storyboard.instantiateViewController(withIdentifier: "welcome")
// 推入导航栈
rootNav.pushViewController(welcomeVC, animated: false)

这样跳转后，welcomeVC就正式加入了导航栈，self.navigationController会正确指向根导航控制器，导航栏的设置、返回按钮等功能都会正常工作。

场景2：目标页面是独立的新流程入口 #

如果你需要目标页面作为一个全新的流程起点（比如引导页、登录页），可以把它包裹在一个新的UINavigationController里再present：

// 实例化目标页面
let storyboard = UIStoryboard(name: "Main", bundle: nil)
let welcomeVC = storyboard.instantiateViewController(withIdentifier: "welcome")
// 创建新的导航控制器，把目标页面作为根VC
let navController = UINavigationController(rootViewController: welcomeVC)
// 提前设置导航栏状态（也可以在welcomeVC的viewDidLoad里设置）
navController.setNavigationBarHidden(false, animated: false)
// present这个导航控制器
self.present(navController, animated: false, completion: nil)

此时welcomeVC的self.navigationController会指向这个新创建的导航容器，所有导航相关操作都能正常执行。

额外注意事项 #

• 确认Storyboard中目标页面的Storyboard ID和你代码里的"welcome"完全一致，避免实例化失败。
• 如果用场景1的方案，要确保App的根控制器确实是UINavigationController（可以在Storyboard的Is Initial View Controller设置里检查）。

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