使用docx4j将Word文档转换为PDF
作者:互联网
2026-04-03
使用 docx4j 实现 DOCX 转 PDF,核心是通过 XSL-FO + Apache FOP 进行格式转换。以下是完整、可直接运行的方案(Maven + Java)。
一、核心依赖(Maven)
需引入 docx4j-core 和 PDF 导出模块 docx4j-export-fo:
<dependencies>
<dependency>
<groupId>org.docx4jgroupId>
<artifactId>docx4j-coreartifactId>
<version>11.5.4version>
dependency>
<dependency>
<groupId>org.docx4jgroupId>
<artifactId>docx4j-export-foartifactId>
<version>11.5.4version>
dependency>
<dependency>
<groupId>org.docx4jgroupId>
<artifactId>docx4j-JAXB-ReferenceImplartifactId>
<version>11.5.4version>
dependency>
dependencies>
二、最简转换代码(含中文支持)
import org.docx4j.Docx4J;
import org.docx4j.fonts.IdentityPlusMapper;
import org.docx4j.fonts.Mapper;
import org.docx4j.fonts.PhysicalFonts;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
public class DocxToPdfConverter {
public static void convert(String docxPath, String pdfPath) throws Exception {
// 1. 加载 DOCX 文件
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(new File(docxPath));
// 2. 配置字体映射(解决中文乱码/方框问题)
Mapper fontMapper = new IdentityPlusMapper();
// 自动扫描系统字体
PhysicalFonts.discoverPhysicalFonts();
// 常用中文字体映射(Windows/Linux通用)
fontMapper.put("宋体", PhysicalFonts.get("SimSun"));
fontMapper.put("微软雅黑", PhysicalFonts.get("Microsoft YaHei"));
fontMapper.put("黑体", PhysicalFonts.get("SimHei"));
fontMapper.put("楷体", PhysicalFonts.get("KaiTi"));
fontMapper.put("隶书", PhysicalFonts.get("LiSu"));
pkg.setFontMapper(fontMapper);
// 3. 转换并输出 PDF
try (OutputStream os = new FileOutputStream(pdfPath)) {
// FLAG_EXPORT_PREFER_XSL:兼容性最好
Docx4J.toPDF(pkg, os);
}
}
// 测试
public static void main(String[] args) throws Exception {
convert("input.docx", "output.pdf");
System.out.println("转换完成");
}
}
三、测试结果
- 原始文档
- 转换效果
四、结论
- 格式兼容性问题比较多,简单文档可以使用,兼容性要求高的情况下,建议放弃
- 由于不能预知要转换的文档中使用了哪些中文字体,可能出现###,这个问题比较严重
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
【从0到1构建一个ClaudeAgent】并发-后台任务
04/17
MyBatis、MyBatis-Plus、JPA、MyBatisGX 写法比较:同一个需求,四种解法
04/17
java2AI系列:SpringAI 通过 Function Calling 接入外部系统
04/17
Java 通用树形结构构建与解析工具类解析
04/17
深度剖析:Java 并发三大量难题 —— 死锁、活锁、饥饿全解
04/17
别再重复造轮子了!SpringBoot对接第三方系统模板,拿来即用
04/17
Spring AI 核心原理解析:基于 1.1.4 版本拆解底层架构
04/16
华为 IODT 设备接入
04/16
自定义跨字段校验必填注解
04/16
别再System.out了!这份SpringBoot日志优雅指南,让你告别日志混乱
04/16
AI精选
