Cordova iOSRTC iPhone真机崩溃 NSInternalInconsistencyException

在iOS真机运行集成iOSRTC的Cordova应用时触发崩溃，相关崩溃日志如下：

libc++abi: terminating with uncaught exception of type NSException
dyld4 config: DYLD_LIBRARY_PATH=/usr/lib/system/introspection DYLD_INSERT_LIBRARIES=/Developer/usr/lib/libBacktraceRecording.dylib:/Developer/usr/lib/libMainThreadChecker.dylib:/Developer/Library/PrivateFrameworks/GPUTools.framework/libglInterpose.dylib:/Developer/Library/PrivateFrameworks/DTDDISupport.framework/libViewDebuggerSupport.dylib

*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Call must be made on main thread'
terminating with uncaught exception of type NSException

崩溃由iOS系统主线程校验机制触发，日志明确抛出NSInternalInconsistencyException，异常原因为Call must be made on main thread：所有UI相关操作、WebRTC渲染相关接口、部分系统框架API强制要求在应用主线程调用，相关代码逻辑被放在子线程执行时，系统会直接触发崩溃。
日志中加载的libMainThreadChecker.dylib是Xcode自带的主线程检查组件，正是该组件捕获到了这次违规的子线程调用。

• Apple macOS: 11.6.6 Big Sur
• Xcode: 13.2.1
• ios-deploy: 1.11.4
• CocoaPods: 1.11.3
• Cordova: 11.0.0
• cordova-platform-ios: 6.2.0
• webrtc-adapter: 8.1.1

• 连接真机复现崩溃时，直接查看Xcode左侧的线程调用栈，筛选属于集成的iOSRTC Cordova插件的栈帧，即可定位到触发主线程检查报错的具体代码行。
• 重点排查三类高风险逻辑：一是WebRTC视频渲染视图（RTCMTLVideoView/RTCEAGLVideoView）的初始化、挂载、布局更新、移除操作；二是摄像头、麦克风采集相关的配置、启停操作；三是插件接收JS层调用、WebRTC信令/状态回调中的UI相关操作。
• 当前调试环境已默认加载Main Thread Checker，崩溃时Xcode会自动高亮标注违规的子线程调用代码，无需逐行手动排查。

• 定位到违规调用代码后，将必须在主线程执行的逻辑通过GCD派发到主线程，Objective-C代码参考如下写法：

dispatch_async(dispatch_get_main_queue(), ^{
    // 写入需要主线程执行的逻辑，比如添加视频视图、更新布局、调用系统API
});

• 若插件部分逻辑由Swift实现，参考如下写法切换到主线程执行：

DispatchQueue.main.async {
    // 写入需要主线程执行的逻辑
}

• 如果使用开源的cordova-plugin-iosrtc插件，优先检查插件版本，部分早期适配Cordova iOS 6.x的版本存在渲染逻辑未派发至主线程的已知问题，可升级到对应修复版本，或手动在插件的视频渲染、WebView挂载相关代码块外层添加主线程派发逻辑。
• 修复完成后可在Xcode中添加异常断点，提前捕获其他潜在的子线程违规调用问题，避免后续出现同类崩溃。

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