Qt QTextDocument打印生成PDF报QPainter::begin()失败崩溃问题

调用document.print(&pdfWriter)时报QPainter::begin() failed、Release模式崩溃的核心原因：

• 程序基于QCoreApplication实现控制台应用，但QTextDocument打印、QPdfWriter的绘制逻辑依赖GUI平台上下文，必须通过QGuiApplication完成平台插件初始化才能正常调用，纯QCoreApplication环境不会加载GUI渲染相关依赖，直接触发绘制失败，Release模式无异常拦截就会直接崩溃。
• Windows虚拟服务器部署时如果遗漏Qt的Windows平台渲染插件，或系统未安装桌面体验组件，会进一步加剧渲染初始化失败问题。

不需要更换技术栈，按以下步骤调整即可正常实现HTML表格转PDF，支持输出到QBuffer：

• 替换应用入口的实例类型：将QCoreApplication a(argc, argv);替换为QGuiApplication a(argc, argv);，该调整不会弹出任何窗口，仅完成GUI渲染依赖的初始化，适配控制台程序运行需求。
• 调整QPdfWriter输出目标为QBuffer，修正后的可运行代码如下：

#include <QGuiApplication>
#include <QPdfWriter>
#include <QTextDocument>
#include <QBuffer>
#include <QMargins>

Q_INVOKABLE QByteArray ScriptCallback::htmlToPdf(const QString& sHtml) {
    qDebug() << "Html To Pdf";
    QBuffer pdfBuffer;
    pdfBuffer.open(QIODevice::WriteOnly);

    QPdfWriter pdfWriter(&pdfBuffer);
    pdfWriter.setPageSize(QPagedPaintDevice::A4);
    pdfWriter.setPageMargins(QMargins(30, 30, 30, 30));
    pdfWriter.setResolution(300); // 可根据需求调整DPI，数值越高PDF清晰度越高

    QTextDocument document;
    document.setHtml(sHtml);
    document.print(&pdfWriter);

    pdfBuffer.close();
    return pdfBuffer.buffer();
}

• 部署适配：Windows虚拟服务器部署时，需要将Qt安装目录下plugins/platforms/qwindows.dll随程序发布，放到程序同级目录的platforms文件夹内；如果服务器是无桌面的Windows Server Core版本，需要先安装系统「桌面体验」功能，补齐系统层面的GUI渲染依赖。

如果不想依赖Qt Gui模块，或服务器环境无法安装桌面组件，可以选择以下方案：

• 轻量原生PDF库方案：使用libharu、PDF-Writer这类纯C++实现的无UI依赖PDF库，手动绘制表格内容生成PDF，不需要任何GUI上下文，纯控制台环境即可运行，内存占用低，部署简单，适合表格结构固定、样式不复杂的场景。
• 无头浏览器渲染方案：如果HTML表格样式复杂、需要兼容CSS高级特性，可以调用系统安装的无头Chrome/Edge的打印指令，或内嵌wkhtmltopdf静态库直接渲染HTML生成PDF，渲染效果和浏览器完全一致，缺点是程序包体积会增加几十MB。

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