使用Apache Batik的PDFTranscoder转换SVG到PDF时标签缺失的解决方法

使用Apache Batik将SVG转换为PDF时默认不会保留SVG的结构标签，要解决这个问题，需开启**Tagged PDF（带标签PDF）**支持，具体操作如下：

1. 升级Batik版本（推荐） #

Batik 1.10版本对Tagged PDF的支持有限，建议升级到1.16或更高版本，新版本的PDF转码器对结构标签的处理更完善。修改Maven依赖：

<dependency>
    <groupId>org.apache.xmlgraphics</groupId>
    <artifactId>batik-transcoder</artifactId>
    <version>1.16</version>
</dependency>

2. 配置转码器参数，开启标签支持 #

在代码中为PDFTranscoder添加两个关键参数，启用结构树和Tagged PDF标记：

import org.apache.batik.transcoder.TranscoderInput;
import org.apache.batik.transcoder.TranscoderOutput;
import org.apache.batik.transcoder.pdf.PDFTranscoder;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;

public class SvgToPdfConverter {
    public static void main(String[] args) throws Exception {
        File svgFile = new File("./target/test.svg");
        PDFTranscoder transcoder = new PDFTranscoder();

        // 启用Tagged PDF和结构树生成
        transcoder.addTranscodingHint(PDFTranscoder.KEY_TAGGED, Boolean.TRUE);
        transcoder.addTranscodingHint(PDFTranscoder.KEY_CREATE_STRUCTURE_TREE, Boolean.TRUE);

        try (FileInputStream inputStream = new FileInputStream(svgFile);
             FileOutputStream outputStream = new FileOutputStream(new File("./target/test-batik-tagged.pdf"))) {
            TranscoderInput input = new TranscoderInput(inputStream);
            TranscoderOutput output = new TranscoderOutput(outputStream);
            transcoder.transcode(input, output);
        }
    }
}

3. 确保SVG标签符合转换要求 #

• 优先使用标准SVG结构标签（如<g>分组、<text>文本、<title>/<desc>语义描述标签），Batik会将这些元素映射为PDF的结构标签。
• 避免使用过于复杂的自定义滤镜或非标准元素，这类元素可能无法被正确转换为PDF结构标签。

验证方式 #

生成PDF后，可通过Adobe Acrobat的「工具 > 检查可访问性」功能，查看PDF的结构树是否包含SVG对应的标签。

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