使用LibreOffice将多页文本/Word文件转为PNG的问题（Java/CLI）

核心问题说明 #

你之前的尝试失败，是因为LibreOffice的PNG导出过滤器要求PageRange等参数必须嵌套在FilterData属性中传递，而非直接作为顶层参数；同时CLI命令需要确保参数格式正确、启用无头模式。

正确CLI命令写法 #

1. 导出指定单页（例如第2页） #

soffice --headless --convert-to 'png:writer_png_Export:{"PageRange": "2"}' test.odt

2. 导出指定页码范围（例如第2到第5页） #

soffice --headless --convert-to 'png:writer_png_Export:{"PageRange": "2-5"}' test.odt

3. 导出所有页（自动生成带页码后缀的PNG文件） #

添加SelectAllPages参数后，LibreOffice会为每一页生成单独的PNG（如test_1.png、test_2.png）：

soffice --headless --convert-to 'png:writer_png_Export:{"SelectAllPages": true}' test.odt

注意：

• 必须加--headless参数以无头模式运行，避免GUI窗口干扰转换；
• Windows系统下需调整引号格式，建议用双引号包裹整个过滤器字符串，内部用单引号，例如：

  soffice --headless --convert-to "png:writer_png_Export:{'PageRange': '2-5'}" test.odt
  

正确Java代码实现 #

Java中需将PageRange嵌套在FilterData属性里，而非直接作为顶层属性：

// 初始化转换属性数组
com.sun.star.beans.PropertyValue[] conversionProperties = new com.sun.star.beans.PropertyValue[2];

// 设置过滤器名称
conversionProperties[0] = new com.sun.star.beans.PropertyValue();
conversionProperties[0].Name = "FilterName";
conversionProperties[0].Value = "writer_png_Export";

// 构建过滤器参数（指定页码范围）
com.sun.star.beans.PropertyValue[] filterData = new com.sun.star.beans.PropertyValue[1];
filterData[0] = new com.sun.star.beans.PropertyValue();
filterData[0].Name = "PageRange";
filterData[0].Value = "2-5"; // 可替换为单页号如"3"

// 将过滤器参数绑定到转换属性
conversionProperties[1] = new com.sun.star.beans.PropertyValue();
conversionProperties[1].Name = "FilterData";
conversionProperties[1].Value = filterData;

导出所有页的Java代码 #

只需修改FilterData中的参数为SelectAllPages：

com.sun.star.beans.PropertyValue[] filterData = new com.sun.star.beans.PropertyValue[1];
filterData[0] = new com.sun.star.beans.PropertyValue();
filterData[0].Name = "SelectAllPages";
filterData[0].Value = Boolean.TRUE;

额外注意事项 #

• 建议使用LibreOffice 7.0及以上版本，旧版本可能存在过滤器参数兼容问题；
• Word文档（.docx/.doc）无需更换过滤器，依然使用writer_png_Export即可；
• 若仍只生成第1页，检查文档是否真的包含多页（需存在分页符，而非单纯换行）。

内容的提问来源于stack exchange，提问作者Madhu Patel