iOS 17.5.1更新后Cordova应用接收VoIP推送异常求助

核心问题分析 #

iOS 17.5及后续版本对WebKit权限管理、后台进程唤醒逻辑做了调整，而Cordova iOS 6.2版本发布时间较早，未适配这些新规则，导致VoIP推送触发时WebKit进程出现授权失效，进而引发应用无响应或崩溃。

排查与解决步骤 #

• 升级Cordova iOS版本
  Cordova iOS 6.2缺乏对iOS 17+的适配支持，优先升级到最新稳定版（如7.1.x及以上），新版本已修复大量系统兼容性问题：

  cordova platform update ios@latest
  

• 优化后台推送处理逻辑
  iOS 17.5对后台线程资源管控更严格，需确保VoIP推送回调中的操作不阻塞主线程：

  • 若使用自定义CallKit插件，将CallKit初始化、Socket连接等耗时操作放到后台线程执行：

    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
        // 初始化CallKit、建立Socket连接等逻辑
    });
    

  • 避免在推送回调中同步调用JS桥接方法，改用异步回调方式与WebView通信。

• 修正WebView与后台权限配置
  在config.xml中强制启用WKWebView并配置相关权限：

  <preference name="WKWebViewOnly" value="true" />
  <preference name="AllowBackgroundWebKit" value="true" />
  

  确认info.plist中后台模式配置完整：

  <key>UIBackgroundModes</key>
  <array>
      <string>voip</string>
      <string>audio</string>
      <string>remote-notification</string>
  </array>
  

• 检查第三方插件兼容性
  若使用第三方VoIP推送/CallKit插件，确认插件已适配iOS 17.5：

  • 替换为维护中的插件版本，或修改插件代码，移除对WebKit授权对象的无效操作。
  • 避免在插件中直接持有WebView的强引用，防止内存泄漏导致授权对象失效。

• 调试WebKit进程状态
  使用Xcode Debug工具定位问题：

  • 通过Debug Navigator查看WebKit进程的线程堆栈，确认是否存在死锁或阻塞。
  • 在推送触发时，用LLDB命令检查WebView授权状态：

    po [WKWebViewConfiguration defaultConfiguration].websiteDataStore.httpCookieStore
    

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