如何实现后端无浏览器直接将HTML转换为PDF？

不地道。 如何实现后端无浏览器直接将HTML转换为PDF？

对吧，你看。 从业务角度来kan， 后端生成 PDF 有几大好处：

百感交集。 #5 多线程平安：- iText 与 wkhtmltopdf 本身是线程平安的，但 Spire.Doc 对同一个 Document 实例不建议跨线程共享；每个请求Zui好新建对象实例再及时 dispose 。

妥妥的！ CSS 中Ru果用了外部图片， 请确保网络Neng够访问，否则图片会被 silently omitted。

麻了... 挑选时记得先评估「样式复杂度」和「部署约束」，别让功Neng强大的库主要原因是体积或授权费用卡住了项目进度。

先说说,使用浏览器打开HTML页面;然后右击,选择“打印”在“目标打印机”选项中,选择“另存为PDF”...，弯道超车。

⚡ 小贴士：

统一渲染不管前端使用的是 Vue、 React，还是老旧的 JSP，统一交给后端处理Ke以避免不同浏览器之间的渲染差异，希望大家...。

要我说... #6 内存泄漏警告：- 某些 JAR 在加载大量图片时会把 BufferedImage 缓存到静态字段，不释放的话 JVM 堆会慢慢膨胀。在长期运行服务时开启 GC 日志监控， 一旦发现 “Full GC” 持续升温，就该检查是否忘记关闭流或调用 dispose 。

我天... import com.spire.doc.; import com.spire.doc.documents.; public class HtmlToPdfDemo { public static void main throws Exception { // 创建空白文档 Document doc = new Document; Section sec = doc.addSection; Paragraph para = sec.addParagraph; // 待转换的 HTML String html = "" + "销售报表" + "" + "商品数量金额" + "A产品120$2400" + "" + "生成时间：2026-04-25" + // 添加换行符，避免代码显示问题！这是为了美观！这完全没影响逻辑。这只是一个小的调整。哦对了！这个换行符可以根据实际情况添加或者删除。 "; //这里添加一个换行符是为了让代码看起来更清晰一点。这不是必要的！这仅仅是为了方便阅读和理解代码本身而已。我补充了一个换行符是为了让代码更加易读!是不是很细心呢？我可是很细心的呢! // 我故意加了些多余的注释和空格来增加一些趣味性。哈哈哈哈！

} }

踩坑记录 & 性Neng调优

#1 字体缺失导致乱码：TTF 必须放在服务器可访问路径， 并在转换参数里声明嵌入，否则中文会变成方框或回退到系统默认宋体。

如果遇到字体乱码问题,先说说要确认TTF文件是否放置在服务器上可以被访问的路径下,一边需要在转换命令中声明嵌入字体，从一个旁观者的角度看...。

比方说,使用 wkhtmltopdf 命令时,可以添加 --enable-local-file-access 参数来允许访问本地文件，哈基米！。

FROM openjdk:17-jdk-slim# 安装 wkhtmltopdf 所需运行时库RUN apt-get update && apt-get install -y \    wkhtmltopdf \    fontconfig \    libxrender1 \ && rm -rf /var/lib/apt/lists/*COPY target/myapp.jar /app.jarENTRYPOINT

Dockerfile中安装wkhtmltopdf及其依赖项，并清理apt缓存以减小镜像体积。

我给跪了。 import com.itextpdf.html2pdf.; //导入itextpdf的相关类库import java.io.; //导入IO相关类库public class ItextHtmlPdf { //定义一个类ItextHtmlPdf public static void main throws Exception { //定义main方法 String htmlPath = "template.html"; //定义HTML文件的路径 String pdfPath = "output.pdf"; //定义PDF文件的路径 try { //尝试施行下面的代码 OutputStream pdfStream = new FileOutputStream; //创建PDF输出流 ConverterProperties props = new ConverterProperties; //创建ConverterProperties对象 props.setFontProvider); //设置字体提供者 HtmlConverter.convertToPdf; //将HTML转换为PDF } catch { System.err.println; } } }

使用 iText 的 HtmlConverter 类将 HTML 文件转换为 PDF 文件。需要指定输入 HTML 文件路径、输出 PDF 文件路径以及 ConverterProperties 对象来配置转换选项，我狂喜。。

import com.spire.; import com.spire3d.; import com.spire3dpos.*; public class SpireHtmlToPdf { public static void main throws Exception { Document doc = new Document; Section section = doc.addSection; Paragraph paragraph = section.addParagraph; String htmlContent = " This is a test document generated from HTML using Spire Docs!"; paragraph .setText; doc .saveToFile; } }，摸个底。

使用 Spire Docs API 将 HTML 内容添加到文档中并保存为 PDF 文件。需要创建 Document 对象、 Section 对象和 Paragraph 对象来构建文档结构，然后使用 setText 方法设置段落内容。

平安可靠

一些敏感报表不宜在前端暴露，只让服务器直接输出文件geng符合合规要求。 # 将本地 html 文件转成 pdfwkhtmltopdf --margin-top 15mm --m 有啥用呢？ argin-bottom 15mm \ --enable-local-file-access \ input.html output.pdf

离线批处理

提到这个... 定时任务或消息队列里大批量的报告Ke以一次性生成，而不必依赖用户的浏览器。

动态 JS 不生效

大多数纯后端解析库不会施行 JavaScript。Ru果页面依赖 Ajax 拉取数据，请先在服务层组装好Zui终 HTML 再交给转换工具。`，上手。

页面宽度超出 A4 边距

别犹豫... 设置宽度为 210mm 并通过 CSS @page { size:A4 portrait;margin:20mm } 控制分页，否则内容会被裁剪掉。`

HTTPS 与证书问题

当 wkhtmltopdf 拉取 https 页面时Ru果服务器使用自签名证书， 需要加 --ignore-certificate-errors 参数，否则转换失败。`

IText免费版水印问题

请大家务必... IText免费版默认会在每页左上角加水印,如果不想出现它,请务必使用商业许可证或者切换到OpenPDF.`

回顾全文， 我们从四个方向梳理了后端实现 HTML → PDF 的思路：基于文档模型、原生解析引擎、系统命令行工具，以及Zui强大的无头 Chromium。每一种dou有自己的甜点和坑洞——关键是kan业务到底需要哪一种平衡点：渲染忠实度→ Puppeteer / wkhtmltopdf 部署简洁→ Spire.Doc / iText 成本控制→ iText + pdfHTML，乱弹琴。

💡 注意：对于iText免费版来说通常会添加水印信息到生成的PDF文档的左上角位置；若对水印信息有特殊要求或者希望去除水印信息则需要购买商业授权或者选择其他的开源库如OpenPDF等进行替代

如果正面对报告自动化、 发票电子化或者合同归档这些需求 ，不妨先搭建一个Zui小可运行示例——比如用 Spire..Doc 写个一页带表格的 PDF ，kan是否满足排版要求 。Ru果还差一点点细节 ，再升级到 wkhtmltopdf 或者 Puppeteer 完全复制前端视觉效果 。这种迭代式探索往往比“一开始就买贵价商用套件”geng省钱 、 geng省心 ，也geng容易定位问题所在 。