iOS应用SwiftUI+UIKit混合开发点击UIScrollView崩溃求助

问题详情 #

• 崩溃现象：应用启动后，触碰UIScrollView区域内任意位置立即崩溃
• 技术实现：SwiftUI框架，通过UIViewRepresentable桥接UIKit的UIScrollView，使用@Observable对象管理UIScrollView属性（因业务需求必须使用UIKit的UIScrollView）
• 已尝试方案：未添加自定义手势，给UIScrollView属性添加@ObservationIgnored无效
• 开发环境：Xcode 16.3、Swift 6.1

崩溃堆栈 #

*** Assertion failure in -[UIGestureGraphEdge initWithLabel:sourceNode:targetNode:directed:], UIGestureGraphEdge.m:28
*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Invalid parameter not satisfying: targetNode'
*** First throw call stack:
(
    0   CoreFoundation                      0x00000001804b910c __exceptionPreprocess + 172
    1   libobjc.A.dylib                     0x0000000180092da8 objc_exception_throw + 72
    2   Foundation                          0x0000000180e67c70 _userInfoForFileAndLine + 0
    3   UIKitCore                           0x0000000185646e98 -[UIGestureGraphEdge initWithLabel:sourceNode:targetNode:directed:] + 316
    4   UIKitCore                           0x0000000185643fb4 -[UIGestureGraph addUniqueEdgeWithLabel:sourceNode:targetNode:directed:properties:] + 328
    5   UIKitCore                           0x0000000185655a48 _UIGestureEnvironmentUpdate + 952
    6   UIKitCore                           0x00000001856553ac -[UIGestureEnvironment _deliverEvent:toGestureRecognizers:usingBlock:] + 324
    7   UIKitCore                           0x00000001856550f8 -[UIGestureEnvironment _updateForEvent:window:] + 156
    8   UIKitCore                           0x0000000185b6be10 -[UIWindow sendEvent:] + 2824
    9   UIKitCore                           0x0000000185b4b80c -[UIApplication sendEvent:] + 376
    10  UIKitCore                           0x0000000185bd5c70 __dispatchPreprocessedEventFromEventQueue + 1156
    11  UIKitCore                           0x0000000185bd8c00 __processEventQueue + 5592
    12  UIKitCore                           0x0000000185bd0f10 updateCycleEntry + 156
    13  UIKitCore                           0x00000001850a5cec _UIUpdateSequenceRun + 76
    14  UIKitCore                           0x0000000185a60858 schedulerStepScheduledMainSection + 168
    15  UIKitCore                           0x0000000185a5fc90 runloopSourceCallback + 80
    16  CoreFoundation                      0x000000018041d294 __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 24
    17  CoreFoundation                      0x000000018041d1dc __CFRunLoopDoSource0 + 172
    18  CoreFoundation                      0x000000018041c940 __CFRunLoopDoSources0 + 232
    19  CoreFoundation                      0x0000000180416e84 __CFRunLoopRun + 788
    20  CoreFoundation                      0x00000001804166f4 CFRunLoopRunSpecific + 552
    21  GraphicsServices                    0x00000001905e5b10 GSEventRunModal + 160
    22  UIKitCore                           0x0000000185b319dc -[UIApplication _run] + 796
    23  UIKitCore                           0x0000000185b35bd4 UIApplicationMain + 124
    24  SwiftUI                             0x00000001d34b9040 $s7SwiftUI17KitRendererCommon33_ACC2C5639A7D76F611E170E831FCA491LLys5NeverOyXlXpFAESpySpys4Int8VGSgGXEfU_ + 164
    25  SwiftUI                             0x00000001d34b8d68 $s7SwiftUI6runAppys5NeverOxAA0D0RzlF + 84
    26  SwiftUI                             0x00000001d323d01c $s7SwiftUI3AppPAAE4mainyyFZ + 148
    27  Web.debug.dylib                     0x0000000101f04830 $s3Web3iOSV5$mainyyFZ + 40
    28  Web.debug.dylib                     0x0000000101f058e0 __debug_main_executable_dylib_entry_point + 12
    29  dyld                                0x0000000100f69410 start_sim + 20
    30  ???                                 0x00000001010aa274 0x0 + 4312441460
)

原因分析 #

从堆栈信息看，崩溃源于UIKit手势识别系统的UIGestureGraphEdge初始化时，targetNode为空触发断言失败。结合SwiftUI与UIKit桥接的场景，核心原因是**UIScrollView实例的生命周期与SwiftUI的状态管理不兼容**：

• @Observable对象的生命周期由SwiftUI的视图更新机制控制，直接持有UIScrollView实例会导致视图被意外释放、重复初始化，破坏手势系统的内部引用关系
• 手势系统尝试访问已被释放的视图节点，从而触发空指针断言

解决建议 #

1. 重构UIScrollView的管理方式 #

避免在@Observable对象中直接持有UIScrollView实例，改为在UIViewRepresentable内部管理视图生命周期，通过Binding或回调传递状态：

struct CustomScrollView: UIViewRepresentable {
    @Binding var contentOffset: CGPoint
    let contentSize: CGSize
    
    func makeUIView(context: Context) -> UIScrollView {
        let scrollView = UIScrollView()
        scrollView.contentSize = contentSize
        scrollView.delegate = context.coordinator
        // 添加子视图等配置
        return scrollView
    }
    
    func updateUIView(_ uiView: UIScrollView, context: Context) {
        // 仅更新必要属性，不重建视图
        if uiView.contentOffset != contentOffset {
            uiView.contentOffset = contentOffset
        }
        if uiView.contentSize != contentSize {
            uiView.contentSize = contentSize
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject, UIScrollViewDelegate {
        private let parent: CustomScrollView
        
        init(_ parent: CustomScrollView) {
            self.parent = parent
        }
        
        func scrollViewDidScroll(_ scrollView: UIScrollView) {
            parent.contentOffset = scrollView.contentOffset
        }
    }
}

2. 检查updateUIView方法的实现 #

确保updateUIView中没有重新创建UIScrollView实例，所有更新操作仅针对传入的现有视图实例。如果存在重建逻辑，会导致旧视图被释放但手势系统仍持有引用，引发崩溃。

3. 修复手势系统异常状态 #

临时禁用再重新启用UIScrollView的默认手势，修复手势系统的内部状态：

func makeUIView(context: Context) -> UIScrollView {
    let scrollView = UIScrollView()
    // 先禁用所有手势
    scrollView.gestureRecognizers?.forEach { $0.isEnabled = false }
    // 延迟重新启用，确保视图初始化完成
    DispatchQueue.main.async {
        scrollView.gestureRecognizers?.forEach { $0.isEnabled = true }
    }
    return scrollView
}

4. 升级或降级开发环境 #

Xcode 16.3可能存在SwiftUI与UIKit桥接的手势系统bug，尝试升级到最新Xcode稳定版本，或降级到Xcode 15.x版本验证问题是否消失。

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