QWebEngineView 如何调试页面

最新推荐文章于 2026-06-05 11:03:55 发布

原创最新推荐文章于 2026-06-05 11:03:55 发布 · 8.6k 阅读

9 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

本文详细介绍如何使用QtWebEngine进行远程调试，包括设置环境变量、启动调试服务器及解决调试中遇到的document.registerElementisnotafunction错误。适用于Qt开发者及Web技术爱好者。

重点是使用 方法  qputenv("QTWEBENGINE_REMOTE_DEBUGGING", "5566");

例子如下：
MainWindow::MainWindow(QWidget *parent) 
:QMainWindow(parent),    
ui(new Ui::MainWindow)
{    
    ui->setupUi(this);   
    qputenv("QTWEBENGINE_REMOTE_DEBUGGING", "5566");    
    QWebEngineView *en = new QWebEngineView(this);   
    en->settings()->setAttribute(QWebEngineSettings::PluginsEnabled, true);     
    en->settings()->setAttribute(QWebEngineSettings::SpatialNavigationEnabled, true);   
    en->setGeometry(0,0,500,500);    
    en->load(QUrl("http://static.jszg.edu.cn/public/tongzhi.html"));
}

在谷歌浏览器里输入 http://17.0.0.1:5566 ，即可调试

调试QWebEngineView中的HTML时，调试页面空白，出现document.registerElement is not a function的原因和解决办法

进入远程调试的页面后没有反应，打开chrome的调试界面出现Uncaught TypeError: document.registerElement is not a function这一错误，很可能是由chrome版本问题导致，可以尝试在程序内使用另一个qwebengineview打开调试地址，或是使用低于80版本的浏览器(79版本的亲测可行)，也许未来更高版本的浏览器或qt会解决这个问题

--enable-blink-features=ShadowDOMV0,CustomElementsV0