SwiftUI应用动态类型转换崩溃问题排查求助

问题描述 #

开发的SwiftUI应用频繁崩溃，崩溃发生在主线程，关联动态类型转换失败，但堆栈指向的位置并未直接使用类型转换。崩溃大多出现在应用进入后台之后，且是在切换为使用@UIApplicationDelegateAdaptor适配自定义AppDelegate后开始出现，错误信息为：

Could not cast value of type 'MyApp.AppDelegate' to 'SwiftUI.AppDelegate'

崩溃堆栈信息 #

Crashed: com.apple.main-thread
0  libsystem_kernel.dylib         0x7558 __pthread_kill + 8
1  libsystem_pthread.dylib        0x7118 pthread_kill + 268
2  libsystem_c.dylib              0x1d178 abort + 180
3  libswiftCore.dylib             0x3b8ba8 swift::fatalError(unsigned int, char const*, ...) + 134
4  libswiftCore.dylib             0x3b8bc8 swift::warningv(unsigned int, char const*, char*) + 30
5  libswiftCore.dylib             0x3aeb90 swift::swift_dynamicCastFailure(swift::TargetMetadata<swift::InProcess> const*, swift::TargetMetadata<swift::InProcess> const*, char const*) + 78
6  libswiftCore.dylib             0x3aec0c swift::_conformsToProtocol(swift::OpaqueValue const*, swift::TargetMetadata<swift::InProcess> const*, swift::TargetProtocolDescriptorRef<swift::InProcess>, swift::TargetWitnessTable<swift::InProcess> const**) + 122
7  libswiftCore.dylib             0x3afd24 swift_dynamicCastClassUnconditionalImpl(void const*, swift::TargetClassMetadata<swift::InProcess, swift::TargetAnyClassMetadataObjCInterop<swift::InProcess> > const*, char const*, unsigned int, unsigned int) + 366
8  SwiftUI                        0x233efc -[BaseDateProvider timeZone] + 964
9  SwiftUI                        0xb70c -[UITableViewCell(SwiftUI) swiftui_defaultRowHeight] + 568
10 SwiftUI                        0x116cd4 OUTLINED_FUNCTION_1165 + 2496
11 UIKitCore                      0x174da8 +[UIScene _sceneForFBSScene:create:withSession:connectionOptions:] + 1036
12 UIKitCore                      0x209c48 -[UIApplication _connectUISceneFromFBSScene:transitionContext:] + 884
13 UIKitCore                      0x209724 -[UIApplication workspace:didCreateScene:withTransitionContext:completion:] + 372
14 UIKitCore                      0x209544 -[UIApplicationSceneClientAgent scene:didInitializeWithEvent:completion:] + 288
15 FrontBoardServices             0x3220 -[FBSScene _callOutQueue_agent_didCreateWithTransitionContext:completion:] + 344
16 FrontBoardServices             0x42fe0 __92-[FBSWorkspaceScenesClient createSceneWithIdentity:parameters:transitionContext:completion:]_block_invoke.80 + 120
17 FrontBoardServices             0x705c -[FBSWorkspace _calloutQueue_executeCalloutFromSource:withBlock:] + 168
18 FrontBoardServices             0x42c38 __92-[FBSWorkspaceScenesClient createSceneWithIdentity:parameters:transitionContext:completion:]_block_invoke + 360
19 libdispatch.dylib              0x3eac _dispatch_client_callout + 20
20 libdispatch.dylib              0x791c _dispatch_block_invoke_direct + 264
21 FrontBoardServices             0x11188 __FBSSERIALQUEUE_IS_CALLING_OUT_TO_A_BLOCK__ + 52
22 FrontBoardServices             0x10d24 -[FBSSerialQueue _targetQueue_performNextIfPossible] + 220
23 FrontBoardServices             0x135d0 -[FBSSerialQueue _performNextFromRunLoopSource] + 28
24 CoreFoundation                 0xd3128 __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 28
25 CoreFoundation                 0xdf7b4 __CFRunLoopDoSource0 + 176
26 CoreFoundation                 0x645e8 __CFRunLoopDoSources0 + 244
27 CoreFoundation                 0x7a0d4 __CFRunLoopRun + 828
28 CoreFoundation                 0x7f3ec CFRunLoopRunSpecific + 612
29 GraphicsServices               0x135c GSEventRunModal + 164
30 UIKitCore                      0x39d6e8 -[UIApplication _run] + 888
31 UIKitCore                      0x39d34c UIApplicationMain + 340
32 SwiftUI                        0x1bc41c OUTLINED_FUNCTION_895 + 2472
33 SwiftUI                        0x1229bc block_copy_helper.1 + 496
34 SwiftUI                        0x10ca64 OUTLINED_FUNCTION_901 + 2752
35 SleepTrackerApp                0xf014 main + 13 (SleepTrackerApp.swift:13)
36 ???                            0x1b72b6dec (Missing)

相关代码 #

SwiftUI.App声明 #

@main
struct SleepTrackerApp: SwiftUI.App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    @Environment(\.openURL) var openURL
    
    @StateObject private var viewModel = PreSplashViewModel()
    @StateObject private var deepLinkHandler = SwiftUIDeepLinkHandler.shared
    @StateObject private var navigationController = NavigationController(rootView: AnyView(PreSplash()))
    
    init() {
        AppDelegate.shared = appDelegate
    }
}

AppDelegate代码 #

class AppDelegate: UIResponder, UIApplicationDelegate, ObservableObject {
    static internal var shared: AppDelegate!

    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
        let sceneConfiguration = UISceneConfiguration(name: "Scene Configuration", sessionRole: connectingSceneSession.role)
        sceneConfiguration.delegateClass = SwiftUISceneDelegate.self
        return sceneConfiguration
    }
    
    ...
}

SceneDelegate代码 #

class SwiftUISceneDelegate: UIResponder, UIWindowSceneDelegate {
    @LazyInjected(\.sleepRecorderManager)
    private var recorderManager
    
    func windowScene(_ windowScene: UIWindowScene, performActionFor shortcutItem: UIApplicationShortcutItem, completionHandler: @escaping (Bool) -> Void) {
        DeepLinkHandler.handle(url, internalDeepLink: true)
    }
    
    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        if let firstUrlContext = connectionOptions.userActivities.first, let url = firstUrlContext.webpageURL  {
            LoggerManager.shared.debug(url.absoluteString)
        }
    }
    
    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        guard let url = URLContexts.first?.url else { return }
        
        SwiftUIDeepLinkHandler.shared.handleDeepLink(url)
    }
}

问题分析 #

从错误信息和堆栈来看，SwiftUI内部在尝试将自定义的AppDelegate实例强制转换为内部私有类型SwiftUI.AppDelegate，引发崩溃。可能的诱因包括：

• 初始化时机错误：在SleepTrackerApp的init中直接赋值单例，此时appDelegate尚未被SwiftUI完全初始化，导致内部状态异常。
• 自定义SceneDelegate冲突：SwiftUI期望使用自身的场景管理逻辑，自定义SwiftUISceneDelegate可能干扰了内部状态。
• 内存管理问题：AppDelegate.shared使用强引用持有实例，导致SwiftUI无法正确管理其生命周期，引发类型混淆。

解决方案 #

方案1：修正AppDelegate单例赋值时机 #

不要在SleepTrackerApp的init中直接赋值单例，而是在AppDelegate的启动方法中设置：

class AppDelegate: UIResponder, UIApplicationDelegate, ObservableObject {
    static internal var shared: AppDelegate!

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        AppDelegate.shared = self
        return true
    }

    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
        let sceneConfiguration = UISceneConfiguration(name: "Scene Configuration", sessionRole: connectingSceneSession.role)
        sceneConfiguration.delegateClass = SwiftUISceneDelegate.self
        return sceneConfiguration
    }
    
    ...
}

同时删除SleepTrackerApp中的init方法：

@main
struct SleepTrackerApp: SwiftUI.App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    @Environment(\.openURL) var openURL
    
    @StateObject private var viewModel = PreSplashViewModel()
    @StateObject private var deepLinkHandler = SwiftUIDeepLinkHandler.shared
    @StateObject private var navigationController = NavigationController(rootView: AnyView(PreSplash()))
    
    // 移除该init方法
}

方案2：改用SwiftUI原生API处理场景逻辑 #

如果场景处理逻辑可以通过SwiftUI原生API实现，建议移除自定义SwiftUISceneDelegate，避免冲突：

@main
struct SleepTrackerApp: SwiftUI.App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    @Environment(\.openURL) var openURL
    @Environment(\.scenePhase) var scenePhase
    
    @StateObject private var viewModel = PreSplashViewModel()
    @StateObject private var deepLinkHandler = SwiftUIDeepLinkHandler.shared
    @StateObject private var navigationController = NavigationController(rootView: AnyView(PreSplash()))
    
    var body: some Scene {
        WindowGroup {
            navigationController.rootView
                .onOpenURL { url in
                    SwiftUIDeepLinkHandler.shared.handleDeepLink(url)
                }
                .onChange(of: scenePhase) { newPhase in
                    // 处理场景状态变化（如后台/前台切换）
                }
        }
    }
}

同时修改AppDelegate的场景配置，不指定自定义SceneDelegate：

func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
    return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
}

方案3：检查自定义NavigationController实现 #

确保自定义NavigationController的实现符合SwiftUI生命周期规则，避免长期持有SwiftUI视图的强引用，防止干扰SwiftUI内部状态管理。

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