QT应用添加QWebEngineView后无渲染仅显示空白屏问题求助

问题原因 #

• 项目配置缺失：未在.pro工程文件中添加QT += webenginewidgets模块声明，虽然编译无报错，但运行时QWebEngineView相关组件无法正常初始化渲染。
• 安全策略限制：Qt WebEngine默认开启混合内容拦截，你加载的HTTP地址http://qt-project.org会自动跳转到HTTPS站点，HTTP请求被安全策略拦截导致页面无内容返回。
• 布局层级问题：你使用的p1Instructions容器如果本身没有被正确添加到主窗口的布局层级中，或者容器的可用尺寸为0，会导致内部的QWebEngineView无法渲染可见。
• 异步加载逻辑问题：QWebEngineView的页面加载是异步操作，你调用show()时页面还未完成加载，部分环境下会出现首次渲染空白的问题。

解决方法 #

1. 先检查.pro工程文件，确保已经添加webenginewidgets模块：

QT += core gui widgets webenginewidgets

添加后执行qmake，再重新编译整个项目。
2. 将加载的HTTP地址替换为HTTPS地址，同时可添加WebEngine属性配置调整测试阶段的安全限制：

// 头文件引入依赖
#include <QWebEngineSettings>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent),
      ui(new Ui::MainWindow),
      instructionView(new QWebEngineView(this)) {
    ui->setupUi(this);
    // 配置WebEngine属性，允许混合内容加载
    instructionView->settings()->setAttribute(QWebEngineSettings::LocalContentCanAccessRemoteUrls, true);
    instructionView->settings()->setAttribute(QWebEngineSettings::AllowRunningInsecureContent, true);
    // 添加到布局
    ui->p1Instructions->addWidget(instructionView);
    // 替换为HTTPS地址
    instructionView->load(QUrl("https://qt-project.org/"));
    // 控件加入布局后会自动随父控件显示，无需手动调用show
}

3. 检查p1Instructions容器的布局配置：确认该容器已经绑定到主窗口的布局中，且布局的对齐方式、拉伸系数设置正确，不要给容器设置固定0大小的尺寸约束。
4. 可绑定loadFinished信号监听加载结果，排查加载失败的具体原因：

// 在构造函数中添加信号绑定
connect(instructionView, &QWebEngineView::loadFinished, this, [=](bool ok){
    if(!ok) {
        qDebug() << "页面加载失败，错误码：" << instructionView->page()->errorCode();
    }
});

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