如何获取QWebEnginePage加载与PDF打印的详细错误信息？

一、HTML加载/解析的详细错误捕获 #

• 监听QWebEnginePage::consoleMessage信号，它可以捕获页面的JS错误、HTML/CSS解析警告等细节，这往往是loadFinished返回false但Chrome能正常加载的核心原因（比如Qt WebEngine与Chrome在特性兼容上的差异，如部分ES6语法、CSS属性支持度不同）。
  示例代码：

connect(page, &QWebEnginePage::consoleMessage, [](QWebEnginePage::ConsoleMessageLevel level, const QString& message, int lineNumber, const QString& sourceID) {
    qDebug() << "[Console]" << message << "Line:" << lineNumber << "Source:" << sourceID;
});

• 利用QWebEnginePage::errorPage信号，当页面出现无法恢复的加载错误时，该信号会触发，可从返回的错误页面内容中提取具体错误描述。

二、PDF生成的详细错误排查 #

• 针对文件系统类错误，在调用printToPdf前做预校验：
  • 用QFileInfo检查目标路径的可写性：QFileInfo(targetPath).isWritable()，同时确认路径不存在非法字符、父目录已创建。
  • 用QStorageInfo获取目标分区的可用空间，提前判断是否满足PDF生成的空间需求。
• 重定向Qt日志输出，捕获底层错误信息：

qInstallMessageHandler([](QtMsgType type, const QMessageLogContext& context, const QString& msg) {
    if ((type == QtWarningMsg || type == QtCriticalMsg) && (msg.contains("PDF") || msg.contains("print"))) {
        qDebug() << "[PDF Error]" << msg;
    }
});

通过这种方式可以捕捉到Qt WebEngine底层输出的文件写入失败、权限不足等细节。

三、loadFinished返回false但Chrome正常加载的额外处理 #

• 调用setHtml加载内容时，务必指定正确的基础URL（第二个参数）。如果HTML依赖本地资源（如CSS、图片），Qt WebEngine可能因基础URL缺失导致资源加载失败，进而触发loadFinished=false，而Chrome会自动补全相对路径。
  示例：

page->setHtml(htmlContent, QUrl::fromLocalFile(QDir::currentPath() + "/"));

• 结合consoleMessage的输出，定位HTML中Qt WebEngine不支持的特性，针对性调整代码。

内容的提问来源于stack exchange，提问作者Mr. Clear