乐于分享
好东西不私藏

【SpringBoot】导出PDF终极解决方案

【SpringBoot】导出PDF终极解决方案

PlayWright:服务端PDF导出的革命性解决方案,完美支持JavaScript动态渲染!

告别传统限制,体验真正的”所见即所得”PDF导出

一、什么是PlayWright?为什么它值得80K GitHub Stars?

PlayWright是微软开源的现代化浏览器自动化工具,你可以理解为它是一个操作浏览器的库,它不仅仅是一个测试框架,更是服务端Web操作的瑞士军刀。与Selenium、Puppeteer等工具相比,PlayWright具有以下颠覆性优势:

  • 🌟 跨浏览器原生支持:Chromium、Firefox、WebKit三大引擎
  • 🥓 多语言支持:Java、Python等
  • 🚀 自动等待机制:智能处理动态内容加载
  • 💪 强大的PDF生成:企业级排版控制能力
  • 🔥 高性能并行:现代异步架构设计

但最让我震撼的是它在服务端PDF导出方面的卓越表现——它能够完美执行JavaScript,这是传统方案无法企及的!就跟你在浏览器中将网页渲染完再按住Ctrl+P打印效果一样的!!!

Github: github.com/microsoft/p…

PlayWright-Java文档:playwright.dev/java/docs/b…

二、实战演示:带JavaScript的动态网页导出PDF

让我们通过一个完整的示例,使用PlayWright-Java展示PlayWright如何处理包含复杂JavaScript的页面。

步骤1:安装PlayWright

第一步:导入Maven依赖:

<dependency><groupId>com.microsoft.playwright</groupId><artifactId>playwright</artifactId><version>1.56.0</version></dependency>

第二步:安装浏览器:每个版本的Playwright都需要特定版本的浏览器二进制文件才能运行。你需要使用Playwright的CLI来安装这些浏览器。每次发布时,Playwright 都会更新它支持的浏览器版本,使最新的 Playwright 随时都能支持最新的浏览器。这意味着每次更新 Playwright 时,你可能需要重新运行 CLI 命令。install。请参阅第四章常见问题解决。

步骤2:示例页面:动态数据报表

假设我们有一个包含图表、动画和异步数据加载的报表页面: 这里我创建一个包含js的网页模板,这里我直接使用模板字符串,很方便,也可以使用FreeMarker/Thymeleaf初步渲染HTML结构再拿到页面字符串。

publicstatic String getPageContent(Map<String,Object> data){Stringcontent="""        <!DOCTYPE html>        <html>        <head>            <title>销售报表</title>            <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>            <style>                .chart-container {                     height: 300px;                     margin: 20px 0;                    opacity: 0;                    transition: opacity 1s;                }                .loaded { opacity: 1; }            </style>        </head>        <body>            <h1>2024年销售数据分析</h1>            <div id="chart1" class="chart-container">                <canvas id="salesChart"></canvas>            </div>            <div id="dynamicContent">正在加载数据...</div>            <script>                // 直接把Java数据以json格式塞进来,就是这么方便!                const data = %s;                // 模拟异步数据加载                setTimeout(() => {                    // 动态生成图表                    const ctx = document.getElementById('salesChart').getContext('2d');                    new Chart(ctx, {                        type: 'bar',                        data: {                            labels: ['1月', '2月', '3月', '4月', '5月', '6月'],                            datasets: [{                                label: '销售额',                                data: [120, 190, 300, 500, 200, 300],                                backgroundColor: 'rgba(75, 192, 192, 0.6)'                            }]                        }                    });                    // 动态更新内容                    document.getElementById('dynamicContent').innerHTML = `                        <h3>数据分析结果</h3>                        <p>最高销售额:<strong>500万元</strong>(4月份)</p>                        <p>平均月增长:<strong>15%</strong></p>                    `;                    // 显示动画效果                    document.getElementById('chart1').classList.add('loaded');                    // 设置页面就绪标志 - 这是关键!                    window.pageReady = true;                }, 2000); // 模拟2秒数据加载            </script>        </body>        </html>    """;/*     * 我们可以直接把json数据塞进页面中,这直接免去了freeMarker模板引擎的工作     * 当然也可以用模板引擎初步渲染html结构。     */return String.format(content, JSON.toJSONString(data))}

这个页面包含了:

  • Chart.js动态图表渲染
  • CSS动画效果
  • 异步数据加载
  • DOM动态更新
  • JSON数据渲染

步骤3:创建PlayWrightUtil工具类

这个工具类包含两个方法,一个是创建浏览器,一个是打印网页内容import com.microsoft.playwright.*;import com.microsoft.playwright.options.LoadState;import com.microsoft.playwright.options.Margin;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import org.springframework.beans.factory.annotation.Value;import org.springframework.stereotype.Component;import java.nio.file.Files;import java.nio.file.Path;import java.nio.file.Paths;import java.util.Arrays;import java.util.HashMap;import java.util.Map;/** * PlayWright无头浏览器 * 官网:https://playwright.dev/java/docs/browsers */@ComponentpublicclassPlayWrightUtil {privatefinalstaticLoggerlogger= LoggerFactory.getLogger(PlayWrightUtil.class);/* 拿到本地浏览器路径 */@Value("${chrome.path}")private String CHROME_PATH;/**     * 创建一个浏览器     * @return browser     */public Browser getBrowser() {// 浏览器配置参数中的环境变量        Map<String, String> env = newHashMap<>();Playwrightplaywright=null;// 配置浏览器参数        BrowserType.LaunchOptionslaunchOptions=newBrowserType.LaunchOptions();        launchOptions.setHeadless(true);        launchOptions.setSlowMo(1000);        launchOptions.setArgs(Arrays.asList("--no-sandbox","--disable-dev-shm-usage","--disable-web-security","--disable-blink-features=AutomationControlled"        ));// 获取本地下载好的浏览器PathchromePath= Paths.get(CHROME_PATH);// 优先使用本地浏览器,如果没找到本地浏览器则下载默认浏览器if (Files.exists(chromePath)){            launchOptions.setExecutablePath(chromePath);            logger.info("已使用本地浏览器:{}", chromePath);            env.put("PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD""1");   // 设置为 "1" 以跳过下载浏览器            playwright = Playwright.create(newPlaywright.CreateOptions().setEnv(env));        }else {            logger.error("已使用默认下载浏览器");            env.put("PLAYWRIGHT_SKIP_BROWSER_GC""1");     // 移除旧的过时浏览器            playwright = Playwright.create(newPlaywright.CreateOptions().setEnv(env));        }// 创建浏览器并返回return playwright.chromium().launch(launchOptions);    }/**     * 打印网页内容     * @param pageContent 网页字符串     * @return pdf字节     */publicbyte[] printPage(String pageContent) {// 拿到浏览器Browserbrowser= getBrowser();// 获取浏览器上下文BrowserContextcontext= browser.newContext();// 创建一个页面Pagepage= context.newPage();// 设置超时和重试策略        page.setDefaultTimeout(30000);        page.setDefaultNavigationTimeout(30000);// 设置 HTML 内容(包含 JavaScript)        page.setContent(pageContent);// 监听网络请求        page.onResponse(response -> {            logger.info("响应网页请求: {} - {}", response.status(), response.url());        });// 等待 JavaScript 执行完成        page.waitForLoadState(LoadState.NETWORKIDLE);// 可以等待特定的 JavaScript 条件        page.waitForFunction("() => window.pageReady === true");// 打印PDFbyte[] a4s = page.pdf(newPage.PdfOptions()                .setMargin(newMargin().setLeft("50").setTop("60").setRight("50").setBottom("60"))                .setPrintBackground(true)                .setFormat("A4")                .setPath(null)                .setDisplayHeaderFooter(true)                .setHeaderTemplate("""                                <div style='font-size: 10px; margin:0 50px 0 50px; width: 100%; display:flex;justify-content: space-between;align-items:center;">'>                                  <span>填你自己的东西</span>                                  <p>生成日期:<span class='date'></span></p>                                </div>                                """                )                .setFooterTemplate("""                                <div style='font-size: 10px; margin:0 50px 0 50px; width: 100%; display: flex; justify-content: space-between;'>                                  <span>© xxxxx科技有限公司. 所有权利保留。</span>"                                  <span>第 <span class='pageNumber'></span> 页 / 共 <span class='totalPages'></span> 页</span>                                </div>                                """                )        );// 关闭浏览器        browser.close();return a4s;    }}

步骤4:创建PDFService类

  • 本类中只有一个generatePdfAndUploadAsync方法用于异步打印pdf并上传文件服务器。无头浏览器打印pdf任务一般我们使用异步操作。
  • PlayWright打印后返回的是byte[]格式数据,需要转为MutilpartFile文件格式才能上传,可以自己封装一个CustomMultipleFile类,这样就无需导入第三方库了。

PdfServiceImpl.java

@ServicepublicclassPdfServiceImplimplementsPdfService {privatefinalstaticLoggerlogger= LoggerFactory.getLogger(PdfServiceImpl.class);@Resourceprivate BizExportService bizExportService;@Resourceprivate DevFileApi devFileApi;@Resourceprivate PlayWrightUtil playWrightUtil;/**     * 生成PDF文件并上传     *     * @param pageContent 网页内容     * @param exportId 导出任务ID     */@Async("taskExecutor")@OverridepublicvoidgeneratePdfAndUploadAsync(String pageContent, String exportId) {BizExportbizExport= bizExportService.queryEntity(exportId);try {// 传入网页字符串开始打印byte[] bytes = playWrightUtil.printPage(pageContent);            logger.info("打印成功");StringfileName= bizExport.getExportId() + ".pdf";// 构造MultipartFile文件并上传MultipartFilemultipartFile=newCustomMultipartFile(bytes, fileName,"application/octet-stream");// 将文件上传到Minio并返回文件URLStringfileUrl= devFileApi.storageFileWithReturnUrlMinio(multipartFile);            logger.info("上传成功,文件地址:{}",fileUrl);// 更新数据(这里根据自己的业务进行调整)            bizExport.setFileUrl(fileUrl);            bizExport.setStatus(BizExportStatusEnum.SUCCESS.getValue());            bizExportService.updateById(bizExport);            logger.info("文件已导出完成,请查看下载");        }catch (Exception e){// 更新数据(这里根据自己的业务进行调整)            bizExport.setStatus(BizExportStatusEnum.FAILED.getValue());            bizExportService.updateById(bizExport);            logger.error("导出PDF任务执行失败,任务ID:{}", bizExport.getExportId());thrownewCommonException("导出PDF任务执行失败,任务ID:{}", bizExport.getExportId());        }    }}

CustomMultiplartFile.java

publicclassCustomMultipartFileimplementsMultipartFile {privatefinalbyte[] fileContent;privatefinal String originalFilename;privatefinal String contentType;publicCustomMultipartFile(byte[] fileContent, String originalFilename, String contentType) {this.fileContent = fileContent != null ? fileContent : newbyte[0];this.originalFilename = originalFilename;this.contentType = contentType;    }@Overridepublic String getName() {return"file";    }@Overridepublic String getOriginalFilename() {returnthis.originalFilename;    }@Overridepublic String getContentType() {returnthis.contentType;    }@OverridepublicbooleanisEmpty() {returnthis.fileContent.length == 0;    }@OverridepubliclonggetSize() {returnthis.fileContent.length;    }@Overridepublicbyte[] getBytes() throws IOException {returnthis.fileContent;    }@Overridepublic InputStream getInputStream()throws IOException {returnnewByteArrayInputStream(this.fileContent);    }@OverridepublicvoidtransferTo(File dest)throws IOException, IllegalStateException {try (FileOutputStreamfos=newFileOutputStream(dest)) {            fos.write(this.fileContent);        }    }}

步骤5:在业务中使用

publicvoidcreateExport(BizExportAddParam addParam) {// 准备数据,可以转为JSON,用String.format()塞入页面中    List<Object> dataList = bizXXXService.getDataList();    Map<String,Object> pageData = newHashMap<>();    pageData.put("exportName",addParam.getName());    pageData.put("dataList",dataList);// 更新状态(正在导出)BizExportbizExport= BeanUtil.toBean(addParam, BizExport.class);    bizExport.setStatus(BizExportStatusEnum.PROCESS.getValue());    bizExport.setOriginData(JSON.toJSONString(pageData));    bizExport.setQuestionNum(addParam.getQuestionIds().size());this.save(bizExport);// 异步打印并上传    pdfService.generatePdfAndUploadAsync(PageUtil.getPageContent(pageData), bizExport.getExportId());}

注意:异步任务不可以在同一个类中被调用,这将会失效。

三、PlayWright PDF导出代码深度解析

代码解析:

下面是我优化后的完整工具类,每个配置都有详细说明:

package vip.xiaonuo.biz.modular.export.utils;import com.microsoft.playwright.*;import com.microsoft.playwright.options.LoadState;import com.microsoft.playwright.options.Margin;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import java.nio.file.Files;import java.nio.file.Path;import java.nio.file.Paths;import java.util.HashMap;import java.util.Map;/** * PlayWright无头浏览器PDF导出工具 * 核心技术亮点:完美支持JavaScript执行,真正的动态内容捕获 */publicclassPlayWrightPDFExporter {privatestaticfinalLoggerlogger= LoggerFactory.getLogger(PlayWrightPDFExporter.class);// 浏览器路径配置 - 支持跨平台,如果使用本地浏览器,需要提前下载好。privatestaticfinalStringWINDOWS_CHROME_PATH="D:/chrome-win64/chrome.exe";privatestaticfinalStringLINUX_CHROME_PATH="/usr/bin/google-chrome";/**     * 智能浏览器实例管理     * 特性1:可以使用本地浏览器或自动下载可靠浏览器     * 特性2:自动降级,确保服务可用性     */publicstatic Browser createBrowser() {        Map<String, String> env = newHashMap<>();Playwrightplaywright=null;        BrowserType.LaunchOptionslaunchOptions=newBrowserType.LaunchOptions()                .setHeadless(true// 无头模式 - 服务端运行关键                .setArgs(Arrays.asList("--disable-web-security"// 禁用安全策略,避免跨域问题"--disable-dev-shm-usage"// 解决Docker内存问题"--no-sandbox"// Linux环境必须                ));// 智能浏览器检测:Windows -> Linux -> 自动下载PathchromePath= detectChromePath();if (Files.exists(chromePath)) {            launchOptions.setExecutablePath(chromePath);            logger.info("✅ 使用本地Chrome浏览器: {}", chromePath);// 跳过自动下载            env.put("PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD""1");        } else {            logger.warn("⚠️ 本地浏览器未找到,使用PlayWright内置浏览器");        }        playwright = Playwright.create(newPlaywright.CreateOptions().setEnv(env));// 选择Chromium(Chrome兼容性最好)return playwright.chromium().launch(launchOptions);    }/**     * 跨平台浏览器路径检测     */privatestatic Path detectChromePath() {Stringos= System.getProperty("os.name").toLowerCase();if (os.contains("win")) {return Paths.get(WINDOWS_CHROME_PATH);        } elseif (os.contains("linux") || os.contains("unix")) {return Paths.get(LINUX_CHROME_PATH);        }return Paths.get(""); // 返回空路径触发自动下载    }/**     * 核心PDF导出方法 - 每个配置都是精华!     * htmlContent:网页字符串     * title:打印标题     */publicstaticbyte[] exportToPDF(String htmlContent, String title) {Browserbrowser=null;try {// 1. 创建浏览器实例            browser = createBrowser();// 2. 创建浏览器上下文(类似隐身模式,隔离环境)BrowserContextcontext= browser.newContext(newBrowser.NewContextOptions()                    .setViewportSize(19201080// 视口大小,也可不设置            );// 3. 创建新页面Pagepage= context.newPage();// 4. 关键配置:超时和重试策略            page.setDefaultTimeout(30000); // 元素操作超时            page.setDefaultNavigationTimeout(60000); // 页面加载超时            logger.info("🚀 开始处理HTML内容,长度: {} 字符", htmlContent.length());// 5. 设置页面HTML内容(可以包含JavaScript),也可以直接请求网页            page.setContent(htmlContent, newPage.SetContentOptions()                    .setWaitUntil(WaitUntilState.NETWORKIDLE) // 等待网络空闲            );// 6. 网络请求监控(调试神器)监控请求外部资源            page.onResponse(response -> {if (response.status() != 200) {                    logger.warn("⚠️ 请求异常: {} - {}", response.status(), response.url());                }            });// 7. 关键等待策略 - 确保所有动态内容加载完成// 等待1:网络空闲(所有异步请求完成)            logger.info("⏳ 等待网络空闲...");            page.waitForLoadState(LoadState.NETWORKIDLE);// 等待2:等待JavaScript自定义就绪标志            logger.info("⏳ 等待JavaScript执行完成...");try {                page.waitForFunction("() => window.pageReady === true"newPage.WaitForFunctionOptions().setTimeout(30000));            } catch (TimeoutException e) {                logger.warn("⏰ 页面就绪超时,继续处理...");            }// 等待3:确保图表渲染完成(针对可视化页面)            logger.info("⏳ 等待图表渲染...");            page.waitForFunction("() => {                const canvas = document.querySelector('canvas');                return canvas && canvas.width > 0;            }", newPage.WaitForFunctionOptions().setTimeout(10000));// 8. 高级PDF配置 - 企业级排版控制            logger.info("📄 生成PDF中...");            Page.PdfOptionspdfOptions=newPage.PdfOptions()// 页面边距:上、右、下、左                    .setMargin(newMargin()                            .setTop("1cm")                            .setRight("1cm"                            .setBottom("2cm"// 底部多留空间给页脚                            .setLeft("1cm"))                    .setPrintBackground(true// ✅ 打印背景色和图片                    .setFormat("A4"// 纸张规格                    .setPreferredSize(210297// A4尺寸(mm)                    .setPath(null// null表示返回字节,不保存文件                    .setDisplayHeaderFooter(true// 显示页眉页脚// 页眉模板:支持CSS和动态数据                    .setHeaderTemplate("""                        <div style="                            font-size: 10px;                             margin: 0 1cm;                            width: 100%;                            display: flex;                            justify-content: space-between;                            align-items: center;                            border-bottom: 1px solid #eee;                            padding-bottom: 5px;                        ">                            <span>${title}</span>                            <span>生成时间: <span class="date"></span></span>                        </div>                        """.replace("${title}", title))// 页脚模板:自动页码计算                    .setFooterTemplate("""                        <div style="                            font-size: 8px;                            margin: 0 1cm;                            width: 100%;                            display: flex;                            justify-content: space-between;                            color: #666;                        ">                            <span>机密文件 · 严禁外传</span>                            <span>第 <span class="pageNumber"></span> 页 / 共 <span class="totalPages"></span> 页</span>                        </div>                        """);byte[] pdfBytes = page.pdf(pdfOptions);            logger.info("✅ PDF生成成功,大小: {} KB", pdfBytes.length / 1024);return pdfBytes;        } catch (Exception e) {            logger.error("❌ PDF生成失败", e);thrownewRuntimeException("PDF导出异常: " + e.getMessage(), e);        } finally {// 9. 资源清理 - 防止内存泄漏if (browser != null) {                browser.close();                logger.info("🧹 浏览器资源已释放");            }        }    }

特性1:智能等待机制 – 解决动态内容核心难题

// 三重等待确保万无一失page.waitForLoadState(LoadState.NETWORKIDLE);        // 网络请求完成page.waitForFunction("() => window.pageReady === true"); // 业务逻辑完成  page.waitForFunction("() => canvas.width > 0");     // 图表渲染完成

为什么这么重要?

  • 传统工具:直接生成,JavaScript没执行完
  • PlayWright:等待所有异步操作完成,真正捕获最终状态

特性2:完整的PDF排版控制

.setHeaderTemplate("""    <div style="font-size: 10px;">        <span>${title}</span>        <span>生成时间: <span class="date"></span></span>    </div>""")

强大之处:

  • class="date"
    :自动替换为当前日期
  • class="pageNumber"
    /class="totalPages":自动页码计算
  • 支持完整CSS样式

特性3:跨平台浏览器管理

privatestatic Path detectChromePath() {Stringos= System.getProperty("os.name").toLowerCase();if (os.contains("win")) return Paths.get(WINDOWS_CHROME_PATH);if (os.contains("linux")) return Paths.get(LINUX_CHROME_PATH);return Paths.get(""); // 触发自动下载}

智能降级策略:

  1. 优先使用本地Chrome(性能最佳)
  2. 自动下载(零配置部署)

四、常见问题解决

  • 问题1:关于浏览器的安装、下载路径、参数配置等问题?

    答:请详细阅读:playwright.dev/java/docs/b…

  • 问题2:文档中/报错信息说使用PlayWright CLI下载系统依赖和浏览器,该如何下载呢?

    答:CLI是PlayWright的脚手架,它的代码地址在com.microsoft.playwright.CLI

    如果你的项目是maven单模块项目:

  • // 1. 先cd到pom所在目录cd xxxxx// 2. 执行mvn installnvm install// 3. 使用CLI安装系统依赖和浏览器。// 如果你使用本地浏览器,删除chromium参数,保留install-deps参数只安装系统依赖即可mvn exec:java --D exec.mainClass=com.microsoft.playwright.CLI-D exec.args="install-deps chromium"

    如果你的项目是maven多模块项目:

  • // 1. 先cd到项目的全局pom所在目录,一般在根目录下cd xxxx// 2. 执行mvn installmvn install// 3. 再cd到playwright被导入使用的模块的pom目录下cd xxxx/xxxx// 4. 使用CLI安装系统依赖和浏览器。// 如果你使用本地浏览器,删除chromium参数,保留install-deps参数只安装系统依赖即可mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install-deps chromium"

    注意:使用mvn指令需要安装maven和jdk哦,再配置一下maven的镜像,这些自己百度一下即可,本文不再赘述。不过我在win平台开发中测试时并不要执行这样的命令去下载浏览器和依赖,PlayWright会自动执行这些操作。但是!!!在linux上就不得行了,即使你使用自己下载的浏览器也依然会报错,因为缺失运行所需依赖。 所以就需要严格按照上述步骤走一遍。这一部分的详细文档请参考playwright.dev/java/docs/b… 和 playwright.dev/java/docs/c… 。系统依赖和浏览器只需要安装一次即可,在linux平台部署时,第一次我把源代码进去执行上述操作安装系统依赖和浏览器,后面就不再需要了。

  • 问题3:Linux平台上怎么安装浏览器呢?怎么找到安装位置呢?

    答:根据我亲测,以Ubuntu平台为例:

  • # 下载Chrome安装包wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb# 更新软件包列表sudo apt update# 安装依赖(如果需要)sudo apt install -y libappindicator3-1# 安装Chromesudo dpkg -i google-chrome-stable_current_amd64.deb# 如果出现依赖问题,修复安装sudo apt --fix-broken install# 查找安装位置which google-chrome# 或which google-chrome-stable# 最后拿到安装位置设置playwright调用本地浏览器路径

    若有其他问题,直接问AI就好了。

  • 问题4:Linux上打印PDF缺失字体怎么办?

    答:我们可以先查看系统中有哪些字体,再安装缺失的字体。这里我以Ubuntu平台为例。

// 检查ubuntu中安装的中文字体fc-list :lang=zh// 检查ubuntu中安装的所有字体fc-list// 安装宋体,字体自己下载,ttf格式。下载后先解压,得到simsun.ttf文件// 进入/usr/share/fonts/truetype目录,创建文件夹simsun并将simsun.ttf拷贝进该目录下mkdir simsuncd simsun  // 假设这里已经拷贝好了simsun.ttf文件// 执行下面指令即可安装完成sudo mkfontscalesudo mkfontdirsudo fc-cache -fv// 再次查看已安装字体fc-list

五、实战效果对比

传统方案(iText、Flying Saucer):

❌ 静态HTML渲染❌ 无法执行JavaScript  ❌ 图表显示为空白框❌ 动态内容缺失

PlayWright方案:

✅ 真实浏览器环境✅ 完整JavaScript执行✅ 图表完美渲染✅ 动画效果保持✅ 异步数据完整

六、性能优化技巧

1. 浏览器实例复用

// 创建浏览器池,避免频繁创建销毁@ComponentpublicclassBrowserPool {privatefinal BlockingQueue<Browser> browserQueue = newLinkedBlockingQueue<>(5);public Browser getBrowser() {// 池化管理实现    }}

2. 资源拦截优化

// 屏蔽不必要资源,提升加载速度page.route("**/*.{png,jpg,jpeg,svg}", route -> route.abort());

3. 缓存策略

// 对相同内容哈希缓存StringcontentHash= DigestUtils.md5Hex(htmlContent);if (cache.containsKey(contentHash)) {return cache.get(contentHash);}

七、为什么PlayWright是PDF导出的终极解决方案?

  1. 真正的浏览器环境
    :不是模拟,是真实的Chromium内核
  2. 完整的Web标准支持
    :ES6+、CSS3、Web API全面兼容
  3. 智能等待机制
    :自动处理异步加载,无需人工估算时间
  4. 企业级PDF输出
    :页眉页脚、页码、边距精细控制
  5. 活跃的生态
    :微软官方维护,持续更新迭代

结语

经过多个生产项目的实践验证,PlayWright已经完全取代了我们之前使用的所有PDF导出方案。从简单的静态报表到复杂的动态仪表盘,它都能完美应对。 特别让人惊喜的是:那些需要先在前端”点击生成报表”按钮才能看到完整数据的复杂页面,PlayWright也能轻松处理——因为它能执行所有的交互JavaScript! 如果你正在为以下问题困扰:

  • 图表在PDF中显示异常
  • 动态数据无法导出
  • 复杂布局错乱
  • 需要人工参与才能生成完整报表

那么,是时候体验PlayWright带来的技术革命了!它不仅仅是一个工具,更是改变你对”服务端Web操作”认知的钥匙。


PlayWright-Java已在实际项目中验证,可直接使用。建议根据文档从简单页面开始,逐步体验PlayWright的强大能力!

作者:CyberShen链接:https://juejin.cn/post/7577718777481347110