Java 使用 Apache Batik 将 SVG 转换为 PNG（指定宽高）

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

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

1. 添加 Maven 依赖

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

xml 复制代码

<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. 核心转换代码

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

java 复制代码

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 基础上扩展。

点赞 + 收藏，遇到问题欢迎评论交流！