QWebEnginePage调用printToPDF无法生成PDF文件

核心问题原因 #

• QWebEnginePage对象生命周期过短：你在栈上创建的QWebEnginePage page会在当前函数执行完毕后立即销毁，而load()是异步操作，页面还没加载完成对象就已不存在，导致loadFinished信号无法触发，调试信息和PDF生成自然都不会执行。

额外排查与优化点 #

• printToPdf()是异步操作，即使loadFinished触发，也需要监听pdfPrintingFinished信号确认生成结果。
• 检查目标路径权限：普通用户通常无/home根目录写入权限，建议改用用户目录路径（如QDir::homePath() + "/output.pdf"）。
• 可通过loadFailed信号排查HTML文件是否加载失败。

修正后的代码示例 #

#include <QWebEnginePage>
#include <QDebug>
#include <QDir>

// 堆分配page，保证生命周期覆盖所有异步操作
QWebEnginePage* page = new QWebEnginePage();
QString outputPath = QDir::homePath() + "/output.pdf";
QString inputPath = "/home/input.html";

// 监听页面加载完成
QObject::connect(page, &QWebEnginePage::loadFinished, [page, outputPath](bool ok) {
    if (!ok) {
        qDebug() << "页面加载失败";
        delete page;
        return;
    }
    qDebug() << 123;
    // 监听PDF打印完成信号
    QObject::connect(page, &QWebEnginePage::pdfPrintingFinished, [page](const QString& filePath, bool success) {
        success ? qDebug() << "PDF生成成功：" << filePath : qDebug() << "PDF生成失败";
        // 操作完成后释放资源
        delete page;
    });
    page->printToPdf(outputPath);
});

// 监听加载失败事件
QObject::connect(page, &QWebEnginePage::loadFailed, [page](const QUrl&, QWebEnginePage::ErrorDomain, int, const QString& errorStr) {
    qDebug() << "加载失败：" << errorStr;
    delete page;
});

page->load(QUrl::fromLocalFile(inputPath));

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