Qt5.15.2中QWebEngine调用runJavaScript时QEventLoop阻塞JS执行问题

• Qt WebEngine的runJavaScript回调必须在主事件循环的空闲调度阶段执行，嵌套的本地QEventLoop默认会阻塞父事件循环的高优先级任务队列，而WebEngine的JS执行请求恰好绑定在顶层事件循环的调度序列上，嵌套循环的WaitForMoreEvents标志会优先处理普通输入事件，反而卡住WebEngine的IPC通信回调调度。
• 单线程应用中，生成界面的逻辑如果在主事件循环未进入空闲状态时触发runJavaScript，此时HTML的布局渲染流水线还未完成，JS函数对应的DOM元素甚至还没完成布局，自然不会执行返回结果。
• Qt 5.15.x版本存在已知的WebEngine嵌套事件循环兼容问题：当runJavaScript调用和嵌套exec()处于同一个函数调用栈时，WebEngine的IPC通道会将回调优先级降到最低，只有嵌套循环退出后才会执行。

可根据业务场景选择以下任意一种方案解决：

• 异步回调重构（官方推荐）
  放弃嵌套事件循环写法，将依赖JS返回值的后续逻辑封装为回调函数，放到runJavaScript的结果回调中执行，符合Qt WebEngine的异步设计规范，代码示例：

  req.get()->m_pWebEngineView->page()->runJavaScript(req.get()->m_strJSFuncSignature, [this](const QVariant& val) {
      // 此处处理返回的元素尺寸、位置数据，执行后续业务逻辑
      processElementGeometry(val.toMap());
  });
  

• 同步逻辑兼容改造
  若必须保留同步执行的业务逻辑，可调整嵌套事件循环的调度参数，调用前主动触发页面布局更新，避免IPC调度阻塞，代码示例：

  // 预执行空JS触发页面待处理任务刷新，确保DOM布局完成
  req.get()->m_pWebEngineView->page()->runJavaScript("void 0");
  QCoreApplication::processEvents(QEventLoop::ExcludeUserInputEvents);
  
  QSharedPointer<QEventLoop> loop = QSharedPointer<QEventLoop>(new QEventLoop());
  req.get()->m_pWebEngineView->page()->runJavaScript(req.get()->m_strJSFuncSignature, [loop](const QVariant& val) {
      if (loop->isRunning()) {
          loop->quit();
      }
  });
  // 移除WaitForMoreEvents标志，循环中主动刷新事件队列避免阻塞IPC回调
  while (loop->exec(QEventLoop::AllEvents) != 0) {
      QCoreApplication::processEvents(QEventLoop::AllEvents, 10);
  }
  

• 调整调用时机
  将runJavaScript的调用逻辑绑定到页面loadFinished信号触发之后执行，确保页面HTML、CSS渲染和DOM布局完全完成后再获取元素属性，避免渲染流程被嵌套循环阻塞。

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