Swinject依赖初始化失败：解析失败且出现nil解包致命错误

问题描述 #

出现以下错误：

Swinject: Resolution failed. Expected registration:
{ Service: LoginViewModel, Factory: Resolver -> LoginViewModel }
Available registrations:
MyApp/MyApp.swift:29: Fatal error: Unexpectedly found nil while unwrapping an Optional value

简化后的代码示例：

DIController.swift #

import Swinject
import Supabase

class DIContainer {
    static let shared = DIContainer()
    let container: Container

    private init() {
        container = Container()
    }

    func initializeDependencies() async {
        container.register(LoginViewModel.self) { resolver in
            LoginViewModel(supabaseClient: supabaseClient)
        }
    }
}

MyApp.swift #

import SwiftUI
import Swinject
import SwiftData

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared

    init() {

        // Initialize dependencies
        Task {
            await DIContainer.shared.initializeDependencies()
        }
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(DIContainer.shared.container.resolve(LoginViewModel.self)!)
        }
    }
}

问题核心原因 #

1. 异步初始化的竞态条件：initializeDependencies是异步方法，在App的init里通过Task调用时，UI渲染逻辑（body）会先执行，此时依赖还没完成注册，resolve返回nil，强制解包触发崩溃。
2. 依赖链缺失：LoginViewModel依赖的supabaseClient既没有在容器中注册，也没有通过resolver获取，导致LoginViewModel的注册逻辑本身就不成立。

解决建议 #

1. 同步依赖初始化时机，确保UI启动前完成注册 #

将异步初始化逻辑改为等待完成后再启动UI，iOS 15+支持异步初始化App：

@main
struct MyApp: App {
    let persistenceController = PersistenceController.shared
    private let diContainer = DIContainer.shared

    init() async {
        await diContainer.initializeDependencies()
    }

    var body: some Scene {
        WindowGroup {
            guard let loginVM = diContainer.container.resolve(LoginViewModel.self) else {
                fatalError("LoginViewModel 未完成注册")
            }
            ContentView()
                .environmentObject(loginVM)
        }
    }
}

2. 补全依赖链，正确注册并解析SupabaseClient #

先在容器中注册SupabaseClient，再通过resolver获取依赖来初始化LoginViewModel：

class DIContainer {
    static let shared = DIContainer()
    let container: Container

    private init() {
        container = Container()
    }

    func initializeDependencies() async {
        // 注册SupabaseClient实例
        container.register(SupabaseClient.self) { _ in
            // 替换为你的Supabase实际初始化参数
            SupabaseClient(supabaseURL: URL(string: "你的Supabase地址")!, supabaseKey: "你的Supabase密钥")
        }
        
        // 通过resolver获取依赖，完成LoginViewModel注册
        container.register(LoginViewModel.self) { resolver in
            LoginViewModel(supabaseClient: resolver.resolve(SupabaseClient.self)!)
        }
    }
}

3. 移除强制解包，增加容错提示 #

避免直接用!强制解包resolve结果，改用安全检查，崩溃时能输出明确的错误信息：

guard let loginVM = diContainer.container.resolve(LoginViewModel.self) else {
    fatalError("LoginViewModel 依赖注册失败，请检查DIContainer配置")
}
ContentView()
    .environmentObject(loginVM)

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