java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot导出PDF

SpringBoot导出PDF的完整解决方案！

作者：CyberShen

本文介绍了PlayWright,一个现代化的浏览器自动化工具,适用于服务端Web操作,它具有跨浏览器支持、多语言、智能等待、强大的PDF生成和高性能并行处理等优势,通过一个实战示例,展示了如何使用PlayWright-Java导出包含JavaScript的动态网页为PDF,需要的朋友可以参考下

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

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

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

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

PlayWright-Java文档：https://playwright.dev/java/docs/browsers

二、实战演示：带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结构再拿到页面字符串。

public static String getPageContent(Map<String,Object> data){
    String content = """
    
        <!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))
}

这个页面包含了：

步骤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
 */
@Component
public class PlayWrightUtil {

    private final static Logger logger = LoggerFactory.getLogger(PlayWrightUtil.class);

    /* 拿到本地浏览器路径 */
    @Value("${chrome.path}")
    private String CHROME_PATH;


    /**
     * 创建一个浏览器
     * @return browser
     */
    public Browser getBrowser() {
        // 浏览器配置参数中的环境变量
        Map<String, String> env = new HashMap<>();

        Playwright playwright = null;
        // 配置浏览器参数
        BrowserType.LaunchOptions launchOptions = new BrowserType.LaunchOptions();
        launchOptions.setHeadless(true);
        launchOptions.setSlowMo(1000);
        launchOptions.setArgs(Arrays.asList(
                "--no-sandbox",
                "--disable-dev-shm-usage",
                "--disable-web-security",
                "--disable-blink-features=AutomationControlled"
        ));

        // 获取本地下载好的浏览器
        Path chromePath = 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(new Playwright.CreateOptions().setEnv(env));
        }
        else {
            logger.error("已使用默认下载浏览器");
            env.put("PLAYWRIGHT_SKIP_BROWSER_GC", "1");     // 移除旧的过时浏览器
            playwright = Playwright.create(new Playwright.CreateOptions().setEnv(env));
        }

        // 创建浏览器并返回
        return playwright.chromium().launch(launchOptions);
    }


    /**
     * 打印网页内容
     * @param pageContent 网页字符串
     * @return pdf字节
     */
    public byte[] printPage(String pageContent) {
        // 拿到浏览器
        Browser browser = getBrowser();
        // 获取浏览器上下文
        BrowserContext context = browser.newContext();
        // 创建一个页面
        Page page = 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");
        // 打印PDF
        byte[] a4s = page.pdf(new Page.PdfOptions()
                .setMargin(new Margin().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类

PdfServiceImpl.java

@Service
public class PdfServiceImpl implements PdfService {

    private final static Logger logger = LoggerFactory.getLogger(PdfServiceImpl.class);

    @Resource
    private BizExportService bizExportService;

    @Resource
    private DevFileApi devFileApi;

    @Resource
    private PlayWrightUtil playWrightUtil;


    /**
     * 生成PDF文件并上传
     *
     * @param pageContent 网页内容
     * @param exportId 导出任务ID
     */
    @Async("taskExecutor")
    @Override
    public void generatePdfAndUploadAsync(String pageContent, String exportId) {
        BizExport bizExport = bizExportService.queryEntity(exportId);
        try {
            // 传入网页字符串开始打印
            byte[] bytes = playWrightUtil.printPage(pageContent);
            logger.info("打印成功");
            String fileName = bizExport.getExportId() + ".pdf";
            // 构造MultipartFile文件并上传
            MultipartFile multipartFile = new CustomMultipartFile(bytes, fileName,"application/octet-stream");
            // 将文件上传到Minio并返回文件URL
            String fileUrl = 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());
            throw new CommonException("导出PDF任务执行失败，任务ID：{}", bizExport.getExportId());
        }
    }
}

CustomMultiplartFile.java

public class CustomMultipartFile implements MultipartFile {
    private final byte[] fileContent;
    private final String originalFilename;
    private final String contentType;

    public CustomMultipartFile(byte[] fileContent, String originalFilename, String contentType) {
        this.fileContent = fileContent != null ? fileContent : new byte[0];
        this.originalFilename = originalFilename;
        this.contentType = contentType;
    }

    @Override
    public String getName() {
        return "file";
    }

    @Override
    public String getOriginalFilename() {
        return this.originalFilename;
    }

    @Override
    public String getContentType() {
        return this.contentType;
    }

    @Override
    public boolean isEmpty() {
        return this.fileContent.length == 0;
    }

    @Override
    public long getSize() {
        return this.fileContent.length;
    }

    @Override
    public byte[] getBytes() throws IOException {
        return this.fileContent;
    }

    @Override
    public InputStream getInputStream() throws IOException {
        return new ByteArrayInputStream(this.fileContent);
    }

    @Override
    public void transferTo(File dest) throws IOException, IllegalStateException {
        try (FileOutputStream fos = new FileOutputStream(dest)) {
            fos.write(this.fileContent);
        }
    }
}

步骤5：在业务中使用

public void createExport(BizExportAddParam addParam) {
    // 准备数据，可以转为JSON，用String.format()塞入页面中
    List<Object> dataList = bizXXXService.getDataList();

    Map<String,Object> pageData = new HashMap<>();
    pageData.put("exportName",addParam.getName());
    pageData.put("dataList",dataList);

    // 更新状态（正在导出）
    BizExport bizExport = 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执行，真正的动态内容捕获
 */
public class PlayWrightPDFExporter {

    private static final Logger logger = LoggerFactory.getLogger(PlayWrightPDFExporter.class);
    
    // 浏览器路径配置 - 支持跨平台，如果使用本地浏览器，需要提前下载好。
    private static final String WINDOWS_CHROME_PATH = "D:/chrome-win64/chrome.exe";
    private static final String LINUX_CHROME_PATH = "/usr/bin/google-chrome";

    /**
     * 智能浏览器实例管理
     * 特性1：可以使用本地浏览器或自动下载可靠浏览器
     * 特性2：自动降级，确保服务可用性
     */
    public static Browser createBrowser() {
        Map<String, String> env = new HashMap<>();
        Playwright playwright = null;
        
        BrowserType.LaunchOptions launchOptions = new BrowserType.LaunchOptions()
                .setHeadless(true) // 无头模式 - 服务端运行关键
                .setArgs(Arrays.asList(
                    "--disable-web-security", // 禁用安全策略，避免跨域问题
                    "--disable-dev-shm-usage", // 解决Docker内存问题
                    "--no-sandbox" // Linux环境必须
                ));

        // 智能浏览器检测：Windows -> Linux -> 自动下载
        Path chromePath = 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(new Playwright.CreateOptions().setEnv(env));
        
        // 选择Chromium（Chrome兼容性最好）
        return playwright.chromium().launch(launchOptions);
    }

    /**
     * 跨平台浏览器路径检测
     */
    private static Path detectChromePath() {
        String os = System.getProperty("os.name").toLowerCase();
        if (os.contains("win")) {
            return Paths.get(WINDOWS_CHROME_PATH);
        } else if (os.contains("linux") || os.contains("unix")) {
            return Paths.get(LINUX_CHROME_PATH);
        }
        return Paths.get(""); // 返回空路径触发自动下载
    }

    /**
     * 核心PDF导出方法 - 每个配置都是精华！
     * htmlContent：网页字符串
     * title：打印标题
     */
    public static byte[] exportToPDF(String htmlContent, String title) {
        Browser browser = null;
        try {
            // 1. 创建浏览器实例
            browser = createBrowser();
            
            // 2. 创建浏览器上下文（类似隐身模式，隔离环境）
            BrowserContext context = browser.newContext(new Browser.NewContextOptions()
                    .setViewportSize(1920, 1080) // 视口大小，也可不设置
            );
            
            // 3. 创建新页面
            Page page = context.newPage();
            
            // 4. 关键配置：超时和重试策略
            page.setDefaultTimeout(30000); // 元素操作超时
            page.setDefaultNavigationTimeout(60000); // 页面加载超时
            
            logger.info("🚀 开始处理HTML内容，长度: {} 字符", htmlContent.length());
            
            // 5. 设置页面HTML内容（可以包含JavaScript），也可以直接请求网页
            page.setContent(htmlContent, new Page.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", 
                    new Page.WaitForFunctionOptions().setTimeout(30000));
            } catch (TimeoutException e) {
                logger.warn("⏰ 页面就绪超时，继续处理...");
            }
            
            // 等待3：确保图表渲染完成（针对可视化页面）
            logger.info("⏳ 等待图表渲染...");
            page.waitForFunction("() => {
                const canvas = document.querySelector('canvas');
                return canvas && canvas.width > 0;
            }", new Page.WaitForFunctionOptions().setTimeout(10000));
            
            // 8. 高级PDF配置 - 企业级排版控制
            logger.info("📄 生成PDF中...");
            Page.PdfOptions pdfOptions = new Page.PdfOptions()
                    // 页面边距：上、右、下、左
                    .setMargin(new Margin()
                            .setTop("1cm")
                            .setRight("1cm") 
                            .setBottom("2cm") // 底部多留空间给页脚
                            .setLeft("1cm"))
                    .setPrintBackground(true) // ✅ 打印背景色和图片
                    .setFormat("A4") // 纸张规格
                    .setPreferredSize(210, 297) // 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);
            throw new RuntimeException("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");     // 图表渲染完成

为什么这么重要？

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

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

强大之处：

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

private static Path detectChromePath() {
    String os = 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：关于浏览器的安装、下载路径、参数配置等问题？

答：请详细阅读：https://playwright.dev/java/docs/browsers#introduction

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

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

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

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

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

// 1. 先cd到项目的全局pom所在目录，一般在根目录下
cd xxxx
// 2. 执行mvn install
mvn 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上就不得行了，即使你使用自己下载的浏览器也依然会报错，因为缺失运行所需依赖。 所以就需要严格按照上述步骤走一遍。这一部分的详细文档请参考https://playwright.dev/java/docs/browsers#introduction和 https://playwright.dev/java/docs/ci-intro。系统依赖和浏览器只需要安装一次即可，在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

# 安装Chrome
sudo 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 simsun
cd simsun  

// 假设这里已经拷贝好了simsun.ttf文件
// 执行下面指令即可安装完成
sudo mkfontscale
sudo mkfontdir
sudo fc-cache -fv

// 再次查看已安装字体
fc-list

五、实战效果对比

传统方案（iText、Flying Saucer）：

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

PlayWright方案：

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

六、性能优化技巧

1. 浏览器实例复用

// 创建浏览器池，避免频繁创建销毁
@Component
public class BrowserPool {
    private final BlockingQueue<Browser> browserQueue = new LinkedBlockingQueue<>(5);
    
    public Browser getBrowser() {
        // 池化管理实现
    }
}

2. 资源拦截优化

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

3. 缓存策略

// 对相同内容哈希缓存
String contentHash = 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！ 如果你正在为以下问题困扰：

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

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

以上就是SpringBoot导出PDF的完整解决方案！的详细内容，更多关于SpringBoot导出PDF的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文