Cordova.js自身回调抛出TypeError错误，求排查方案

问题背景 #

报错详情：

ErrorIn = https://myapp/cordova.js
ErrorAt = 314 : 13
Message = Uncaught TypeError: Cannot read properties of undefined (reading 'message')

报错触发于callbackFromNative函数的catch块中这一行：

cordova.fireWindowEvent('cordovacallbackerror', { message: msg, error: err });

环境：Cordova CLI 11.1.0，cordova-android 11.0.0，仅三星Android设备出现该问题。

排查建议 #

• 临时兜底错误对象，收集详细日志
  直接修改cordova.js里的catch块代码，先对err做兜底处理，避免当前TypeError，同时收集更准确的错误信息：

  catch (err) {
      const safeErr = err || {};
      const msg = 'Error in ' + (isSuccess ? 'Success' : 'Error') + ' callbackId: ' + callbackId + ' : ' + (safeErr.message || String(safeErr));
      cordova.fireWindowEvent('cordovacallbackerror', { message: msg, error: safeErr });
      throw safeErr;
  }
  

  这样修改后，既能阻止当前报错扩散，还能拿到更具体的错误内容，帮助定位根源。

• 排查三星WebView的特性差异
  三星自带WebView可能存在特殊行为：

  • 检查测试机上三星WebView的版本，对比其他品牌设备的WebView版本，尝试升级或降级WebView验证问题是否复现。
  • 在catch块中添加日志，打印typeof err、JSON.stringify(err)（如果可序列化），确认err的实际类型和内容——三星WebView可能对Error对象的传递做了特殊处理，导致err为undefined或非标准对象。

• 追踪触发报错的原生回调来源
  从callbackId入手定位问题插件：

  • 在cordova.exec注册回调的逻辑里，新增日志记录callbackId对应的插件名称、动作类型。
  • 在callbackFromNative函数开头就打印callbackId、isSuccess、status、args等参数，结合用户操作日志，找到是哪个插件的哪个动作触发了异常。

• 验证cordova-android版本兼容性
  cordova-android 11.0.0对应Android API 32，三星部分旧设备可能存在适配问题：

  • 尝试升级cordova-android到最新稳定版（如12.x或13.x），测试问题是否消失。
  • 或者降级到cordova-android 10.x版本，排查是否是版本适配导致的异常传递问题。

• 定位问题插件并检查原生代码
  仅三星设备出现问题，大概率是第三方插件的原生代码在三星设备上抛出异常，且传递到JS层时出错：

  • 逐个禁用第三方插件，测试应用是否还会报错，定位到具体插件。
  • 查看该插件的Android原生代码，检查是否有未捕获的异常，尤其是调用三星设备独有的硬件/系统API的部分。

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