JS调用ActiveX DLL原生方法返回后 后续代码偶发不执行问题咨询

可能原因 #

• ActiveX同步调用的COM线程交互异常：ActiveX的同步调用运行在浏览器UI线程上，native侧的while(1)轮询会长时间占用线程，虽然日志显示执行完成，但偶发会出现Windows消息队列堵塞，COM层没有把执行完成的信号抛回JS上下文，导致JS侧的调用一直处于等待状态，但JS引擎本身没有崩溃，所以其他JS逻辑可以正常执行。
• COM交互异常被静默吞吃：native方法执行完成后，返回值做JS类型编组的过程中如果出现异常（比如返回值类型不兼容、内存访问错误），COM层可能不会把异常抛到JS层，直接导致当前调用挂起，后续代码不会执行。
• Vue异步队列调度冲突：如果jsmethods是在Vue的微任务阶段（比如watch回调、响应式更新钩子、Promise回调内）触发，同步的ActiveX调用会堵塞微任务队列，偶发会出现返回后队列调度优先级异常，后续代码被永久挂起。
• native侧分支逻辑无明确返回：如果native代码存在未覆盖的分支，没有明确的返回值，COM层会一直等待返回信号，也会导致JS侧调用卡住。

排查解决办法 #

• 优先改同步调用为异步回调模式：修改ActiveX的接口逻辑，不要用同步返回的方式传值，native侧逻辑执行完成后主动调用JS全局注册的回调函数传递结果，从根源上避免同步调用堵塞线程的问题。示例逻辑：

// JS侧提前注册回调
window.onNativeResult = (nativeRes) => {
  let res = {"nativeResult":nativeRes};
  // 原后续逻辑
}
// 调用native方法不需要接收返回值
controller.nativeMethods("some args");

• 全链路加异常捕获：JS侧调用ActiveX方法的外层加try-catch捕获所有异常，native侧所有执行分支都加异常捕获，确保所有场景下都有明确的返回值，哪怕是错误场景也要返回固定格式的错误标识。

// JS侧异常捕获示例
function jsmethods(){
  let i = 0;
  i++;
  let controller = document.getElementById("ocxControllerId");
  try {
    let nativeRes = controller.nativeMethods("some args");
    let res = {"nativeResult":nativeRes};
    return res;
  } catch (e) {
    console.error('ActiveX调用异常', e)
    // 兜底逻辑
    return {"nativeResult": null, error: e.message}
  }
 }

• 优化native侧轮询逻辑：把while(1)的死循环轮询改成每次轮询加10~50ms的Sleep，让出CPU时间片，避免长时间占满UI线程导致消息队列堵塞，同时可以降低硬件轮询的性能消耗。
• 调整调用时机到宏任务队列：不要在Vue的微任务阶段调用该同步方法，用setTimeout把调用逻辑放到宏任务队列执行，避免和Vue的异步更新队列产生调度冲突：

setTimeout(() => {
  jsmethods()
}, 0)

• 统一返回值类型：native侧的返回值统一用字符串、数字等JS可直接识别的基础类型，如果需要返回复杂结构，转成JSON字符串返回，JS侧再做解析，避免类型编组失败导致的调用挂起。

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