iOS开发：SwiftUI迁移中Hosting Controller回跳Storyboard实现方法

核心逻辑：渐进式迁移阶段要把导航控制权保留在UIKit层，不打乱现有Storyboard的导航栈结构，通过闭包桥接把SwiftUI侧的跳转意图传递给承载它的UIKit容器执行即可。

具体实现 #

1. 给SwiftUI视图注入可回调的跳转动作
   不要在SwiftUI视图内部硬写UIKit跳转逻辑，把跳转动作做成外部可传入的闭包，实现视图和导航逻辑解耦：

   struct SwiftUIModuleView: View {
       // 上层UIKit容器注入的跳转触发回调
       var jumpToController2Action: (() -> Void)?
   
       var body: some View {
           Button("跳转到Storyboard的Controller2") {
               jumpToController2Action?()
           }
       }
   }
   

2. 初始化HostingController时绑定跳转逻辑
   你原本从Controller1（Storyboard页面）跳转到HostingController的流程里，直接把Storyboard实例化、控制器跳转的逻辑写进闭包，完全适配现有Storyboard的导航规则：

   // Controller1中原有的正向跳转代码
   let rootView = SwiftUIModuleView(
       jumpToController2Action: { [weak self] in
           // 从对应Storyboard实例化Controller2
           let storyboard = UIStoryboard(name: "Main", bundle: nil)
           guard let controller2 = storyboard.instantiateViewController(
               withIdentifier: "Controller2"
           ) as? UIViewController else { return }
   
           // 匹配现有呈现方式执行跳转
           // HostingController被push到导航栈的场景
           if let nav = self?.navigationController {
               nav.pushViewController(controller2, animated: true)
           // HostingController被模态present的场景
           } else {
               self?.present(controller2, animated: true)
           }
       }
   )
   
   let hostingVC = UIHostingController(rootView: rootView)
   self.navigationController?.pushViewController(hostingVC, animated: true)
   

常见踩坑说明 #

• 禁止通过UIApplication.shared.keyWindow?.rootViewController全局取根控制器跳转：这种写法在多层present、导航栈嵌套的场景下极易取错控制器，造成导航层级错乱，完全违背渐进迁移的隔离原则
• 闭包内捕获控制器时必须加[weak self]弱引用：否则会形成闭包对导航控制器的强持有，触发内存泄漏
• 不要混用SwiftUI原生NavigationLink跳转UIKit控制器：SwiftUI的独立导航系统和现有Storyboard维护的UIKit导航栈不互通，混用会造成返回栈混乱、侧滑返回手势失效等问题

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