Ionic-Capacitor展示SDK视图崩溃：NSJSONSerialization参数nil问题

排查与解决步骤 #

虽然崩溃提示指向NSJSONSerialization，但本质是present流程中Capacitor内部序列化操作传入了nil值，从以下方向逐一排查：

• 检查SDK控制器初始化完整性
  确认someController的所有必填参数都已配置，避免因初始化不完整导致控制器内部生成nil配置数据，触发桥接时的序列化错误。可在present前打印控制器的关键属性，确认无nil值。

• 验证Bridge视图控制器状态
  调用present前先确认self.bridge?.viewController有效且处于活跃状态：

  guard let presentingVC = self.bridge?.viewController, presentingVC.view.window != nil else {
      print("Bridge视图控制器无效或未挂载到窗口")
      return
  }
  presentingVC.present(someController, animated: true, completion: nil)
  

• 排查插件回调数据
  若自定义插件存在JS到原生的回调，检查call.resolve()或call.reject()是否传入了nil值。Capacitor会序列化回调数据，nil值直接触发该崩溃，确保传递的参数是合法JSON对象。

• 改用Capacitor官方导航方式
  避免直接操作原生viewController，优先使用Capacitor提供的Modals插件，或遵循Capacitor插件规范处理视图跳转，确保内部序列化流程正常。

• 添加异常捕获与断点定位
  在Xcode中开启异常断点，直接定位触发崩溃的具体代码行；也可手动捕获序列化异常，打印详细堆栈：

  do {
      // 替换为你怀疑的序列化数据
      try NSJSONSerialization.data(withJSONObject: targetData, options: [])
  } catch let error {
      print("JSON序列化错误: \(error)")
      print("堆栈信息: \(Thread.callStackSymbols)")
  }
  

额外处理方案 #

若SDK要求必须在UINavigationController上present，可将SDK控制器包装后再展示：

let navController = UINavigationController(rootViewController: someController)
self.bridge?.viewController?.present(navController, animated: true, completion: nil)

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