iText 7 适合从零生成高定制PDF(如中文合同),PDFBox 擅长解析/修改已有PDF;iText 7需BOM统一版本并排除slf4j-simple,PDFBox需显式引入fontbox;中文字体必须指定Identity-H编码且禁用file://路径。
iText 7 和 PDFBox 的选型冲突怎么破
Java 项目里想生成 PDF,
和
常被同时搜到,但它们不是互补关系,而是不同设计哲学的方案——选错一个,后期改起来成本很高。
简单说:
是“主动构建型”,适合需要精细控制排版、表格、字体嵌入、数字签名等场景;
更偏向“底层操作型”,擅长解析已有 PDF、加水印、填表单、提取文本,生成能力弱且 API 繁琐。
如果你要从零生成带中文表格+页眉页脚+自定义字体的合同 PDF,优先用
如果你只是读取用户上传的 PDF、盖个章、再返回,
更轻量、无商业许可风险
已停止维护,别用;
社区版(AGPL)要求开源你的代码,商用必须买授权;
是 Apache 2.0,无限制
Maven 依赖怎么写才不踩类冲突坑
直接粘贴官网给的依赖,大概率在 Spring Boot 项目里报
或字体渲染异常——根本原因是日志、字体、IO 库版本打架。
关键不是“加什么”,而是“加哪些 + 排除哪些”:
立即学习
“
Java免费学习笔记(深入)
”;
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法;希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
下载
iText 7 必须引入核心三件套:
(用 BOM 控制版本),否则
、
、
各自拉不同版本的
,Spring Boot 的
就会炸
PDFBox 不要只加
,还得显式加上
和
(虽然文档说可选),否则中文字体加载失败、中文乱码成方块
如果项目已用
,iText 的
依赖必须
掉,否则启动时抢日志绑定
示例(iText 7.2.x):
中文显示不出来?八成是字体和编码没对上
不管是 iText 还是 PDFBox,只要 PDF 里中文变空白或方块,问题几乎都出在字体路径、加载方式、编码声明这三处。
iText 7 中,
加载的字体文件路径不能用
绝对路径(容器部署时必挂),要用
或
PDFBox 中,
必须指定
编码,且字体文件本身得是支持 Unicode 的(如 NotoSansCJK、simhei.ttf),用宋体 .ttc 文件会失败
iText 7 的
默认用 Helvetica,不支持中文,必须显式传
别信“设置 BaseFont.IDENTITY_H 就行了”这种过时说法——iText 7 没有
,那是 iText 5 的东西
生成速度慢、内存爆掉?检查 PDF 内容构造方式
生成几百页 PDF 时卡死、OOM,往往不是库本身的问题,而是调用姿势不对。
iText 7 中,避免在循环里反复调用
——每句都触发 layout 计算。改用
或
批量装内容,最后一次性
PDFBox 生成新 PDF 时,不要用
直接写磁盘,先用
写入内存,再转
返回给 Web 层;否则大文件会撑爆堆内存
两者都禁用调试日志:iText 设置
;PDFBox 设置
PDFBox 的
必须显式
,否则底层
句柄泄漏,Linux 下跑几天就
字体加载、日志、资源关闭,这些点看着小,但线上一跑就是雪崩点——没人告诉你,但每个都得亲手踩一遍才信。
iTextPDFBoxiText 7PDFBoxiText 7PDFBoxiText 5iText 7PDFBoxNoClassDefFoundErroritext7-corekernellayoutpdfaslf4jspring-boot-starter-loggingpdfboxfontboxjempboxlogbackslf4j-simple
com.itextpdf
itext7-core
7.2.5
pom
import
FontProviderfile://getClass().getResource("/fonts/simhei.ttf")new PdfFontFactory().createFont(...)PDType0Font.load()Identity-HDocument.add(new Paragraph("测试"))new Paragraph("测试").setFont(PdfFontFactory.createFont(...))BaseFontdocument.add(new Paragraph(...))DivTableadd()PDDocument.save()ByteArrayOutputStreambyte[]Logger.getLogger("com.itextpdf").setLevel(Level.OFF)System.setProperty("org.apache.pdfbox.rendering.LogLevel", "OFF")PDDocumentclose()RandomAccessFileToo many open files