Swinject环境下iOS项目Storyboard模块实例管理及VC标识匹配报错问题
问题根因定位

你遇到的报错本质是原生Storyboard加载逻辑和Swinject的DI链路完全脱节,具体诱因包括:
- 代码中同时混用了原生
UIStoryboard和SwinjectStoryboard两类实例化逻辑,没有给每个模块的Storyboard绑定对应的DI容器 - 所有依赖都注册在Swinject的全局默认容器中,没有拆分独立容器,无法实现主模块实例随登出彻底销毁的需求
- 启动时重复加载同一个Storyboard,且没有通过Swinject的链路实例化主Tab控制器,导致系统在自动加载流程中走了空的Swinject默认初始化,最终抛出找不到对应控制器ID的错误
分步调整实现方案
1. 拆分三级独立容器,实现模块作用域隔离
彻底抛弃把所有依赖堆在全局defaultContainer的写法,按模块拆分层级化的容器结构:
- 最外层是全局共享容器:存放跨两个模块都需要的公共依赖(比如
UserProvider),作为所有子容器的父容器 - 登录模块专属容器:以全局容器为父容器,注册登录流程内的所有依赖,生命周期和App一致
- 主模块专属容器:以全局容器为父容器,不做提前初始化,每次进入主模块时新建,登出时直接置空,容器关联的所有依赖实例会随容器释放被系统回收
示例代码:
// 全局共享父容器 let globalContainer = Container() // 登录模块固定生命周期容器 let loginContainer = Container(parent: globalContainer) // 主模块动态生命周期容器:登出时置空即可销毁所有关联实例 var mainContainer: Container?
2. 绑定模块容器到对应Storyboard,解决控制器实例化报错
不要用原生UIStoryboard加载需要DI注入的页面,所有业务模块的Storyboard都要通过Swinject的专属方法创建,传入对应的模块容器:
// 通用的主模块重建方法:每次登录完成/启动时已登录的场景都调用 func rebuildMainModule() { // 每次进入主模块都生成全新的容器,保证实例干净 mainContainer = Container(parent: globalContainer) // 在新建的主模块容器内注册所有主模块的依赖 mainContainer?.register(HomeViewModel.self) { resolver in HomeViewModel(userProvider: resolver ~> UserProvider.self) } mainContainer?.storyboardInitCompleted(HomeViewController.self) { resolver, vc in vc.viewModel = resolver ~> HomeViewModel.self } // 用主模块容器创建绑定了DI链路的Storyboard let mainStoryboard = SwinjectStoryboard.create( name: "Main", bundle: nil, container: mainContainer! ) // 直接获取Storyboard的初始控制器,不再需要手动匹配Storyboard ID let mainTabVC = mainStoryboard.instantiateInitialViewController() as? MainTabBarController window?.rootViewController = mainTabVC }
关键说明:只要通过
SwinjectStoryboard.create传入对应容器创建的Storyboard,就能自动识别内部的控制器ID,不会再触发“找不到对应控制器”的报错,这部分逻辑是Swinject内置处理的。
3. 拆分依赖注册逻辑,按模块绑定到对应容器
把原来集中在SwinjectStoryboard.setup()里的注册逻辑按模块拆分:
extension SwinjectStoryboard { @objc class func setup() { // 全局共享依赖注册到全局容器 globalContainer.register(UserProvider.self) { _ in UserProvider() }.inObjectScope(.container) // 登录模块的依赖注册到loginContainer loginContainer.storyboardInitCompleted(LoginNavigationController.self) { _, _ in } loginContainer.storyboardInitCompleted(LoginViewController.self) { resolver, vc in vc.userProvider = resolver ~> UserProvider.self } } }
注意:主模块的依赖不要在这个全局setup方法里提前注册,必须在每次调用rebuildMainModule新建mainContainer时再注册,否则容器释放时实例无法被彻底销毁
4. 改造启动时的根控制器切换逻辑
把原来scene(_:willConnectTo:)方法里的原生Storyboard代码全部替换为基于Swinject的实现:
func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { guard let windowScene = (scene as? UIWindowScene) else { return } window = UIWindow(windowScene: windowScene) // 启动时根据登录态切换根控制器 if UserDefaults.standard.string(forKey: "username") != nil { // 已登录:重建全新的主模块链路 rebuildMainModule() } else { // 未登录:加载绑定了loginContainer的登录Storyboard let loginStoryboard = SwinjectStoryboard.create( name: "Login", bundle: nil, container: loginContainer ) window?.rootViewController = loginStoryboard.instantiateInitialViewController() } window?.makeKeyAndVisible() }
登出逻辑的实现
完成上述配置后,登出流程只需要两步就能实现主模块实例的彻底销毁:
- 清除本地登录态缓存
- 将
mainContainer置空,重新加载登录模块的Storyboard作为根控制器
主模块关联的所有控制器、依赖实例因为没有任何强引用持有,会被系统自动回收,完全匹配“登录完成生成全新主模块实例、登出销毁所有实例”的需求。
常见校验注意点
- 确保两个模块的控制器拆分到独立的Storyboard文件中:登录模块所有页面放到
Login.storyboard,主模块所有页面放到Main.storyboard,不要混放导致容器绑定混乱 - 给每个Storyboard设置对应的初始控制器,调用
instantiateInitialViewController时不需要手动匹配控制器ID,能减少ID拼写错误导致的报错 - 不要混用原生
UIStoryboard和SwinjectStoryboard:只要是需要DI注入的页面,必须从绑定了对应容器的SwinjectStoryboard中实例化,否则会出现依赖为nil的崩溃 - 检查Xcode项目配置里的默认启动Storyboard设置:如果是手动创建
UIWindow的逻辑,要在Target的General设置里删掉Storyboard的启动配置,避免系统自动加载默认Storyboard触发空Swinject初始化的报错
内容的提问来源于stack exchange,提问作者yongwoo lee
相关产品推荐
相关产品推荐

