Java使用Apache Batik实现将SVG转换为PNG

2026-01-21 15:32:28 作者：weixin_46244623

在项目中经常需要将 SVG 图标或图形转换为 PNG 格式,Apache Batik 是一个强大的 SVG 处理库,可以轻松实现 SVG → PNG 的转换,下面我们就来看看具体实现方法吧

在项目中经常需要将 SVG 图标或图形转换为 PNG 格式，比如生成固定尺寸的 favicon、图标等。Apache Batik 是一个强大的 SVG 处理库，可以轻松实现 SVG → PNG 的转换。

本文介绍一种简单可靠的方法：通过网络 URL 获取 SVG，并转换为指定宽高的 PNG 文件。

1. 添加 Maven 依赖

在 pom.xml 中添加 Apache Batik 依赖（推荐使用较新版本）：

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

注意：Batik 不同模块需要一起引入，batik-transcoder 负责转换，batik-codec 提供 PNG 编码支持。

2. 核心转换代码

创建一个工具类，直接提供一个静态方法即可调用：

import org.apache.batik.transcoder.Transcoder;
import org.apache.batik.transcoder.TranscoderException;
import org.apache.batik.transcoder.TranscoderInput;
import org.apache.batik.transcoder.TranscoderOutput;
import org.apache.batik.transcoder.image.PNGTranscoder;

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URL;
import java.net.URLConnection;

public class SvgToPngConverter {

    /**
     * 将网络上的 SVG 转换为指定宽高的 PNG
     *
     * @param svgUrl      SVG 文件的 URL
     * @param pngFilePath 输出的 PNG 文件路径
     * @param width       目标宽度（像素）
     * @param height      目标高度（像素）
     * @throws IOException       IO 异常
     * @throws TranscoderException 转换异常
     */
    public static void convertSvgToPng(String svgUrl, String pngFilePath, int width, int height)
            throws IOException, TranscoderException {

        // 1. 打开网络连接获取 SVG 输入流
        URL url = new URL(svgUrl);
        URLConnection connection = url.openConnection();
        try (InputStream inputStream = connection.getInputStream();
             OutputStream outputStream = new FileOutputStream(pngFilePath)) {

            // 2. 创建 PNG 转换器
            Transcoder transcoder = new PNGTranscoder();

            // 3. 设置目标宽高（关键！）
            transcoder.addTranscodingHint(PNGTranscoder.KEY_WIDTH, (float) width);
            transcoder.addTranscodingHint(PNGTranscoder.KEY_HEIGHT, (float) height);

            // 4. 设置输入和输出
            TranscoderInput input = new TranscoderInput(inputStream);
            TranscoderOutput output = new TranscoderOutput(outputStream);

            // 5. 执行转换
            transcoder.transcode(input, output);
        }
        // try-with-resources 会自动关闭流
    }

    // 测试调用示例
    public static void main(String[] args) {
        try {
            String svgUrl = "https://example.com/favicons/favicon.svg";
            String pngPath = "favicon_64.png";

            convertSvgToPng(svgUrl, pngPath, 64, 64);
            System.out.println("SVG 转换为 PNG 成功！输出文件：" + pngPath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 代码说明

网络获取 SVG：通过 URLConnection 获取输入流，支持任何公开的 SVG URL。

指定宽高：使用 PNGTranscoder.KEY_WIDTH 和 KEY_HEIGHT 提示，确保输出 PNG 为指定尺寸（会等比例缩放并居中）。

资源自动关闭：使用 try-with-resources，避免资源泄漏。

异常处理：建议在实际项目中记录日志，而不是静默吞异常。

4. 运行效果

运行 main 方法后，会在项目根目录生成 favicon_64.png，大小正好是 64×64 像素。

5. 常见问题

转换后图像空白：检查 SVG URL 是否有效、是否支持 CORS（Batik 直接读流通常没问题）。

尺寸不准：确保传入的 width/height 是 float 类型（Batik 要求）。

本地 SVG 文件：如果不是网络 URL，可直接用 new FileInputStream("local.svg") 替换输入流。

这个方法简单高效，无需额外图形库，适合后端服务批量生成图标。如果有更多需求（如添加背景、水印），可以在 Batik 基础上扩展。

到此这篇关于Java使用Apache Batik实现将SVG转换为PNG的文章就介绍到这了,更多相关Java SVG转PNG内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！