Java中如何将Data URI字符串转换为File对象？

这是个很常见的坑——我当初第一次用Data URI碰File对象也踩过这个异常！先给你明确答案：可以把Data URI转换成File对象，但不能直接通过new File(URI)的方式，原因和解决方法如下：

为什么会抛出URI is not hierarchical异常？ #

Java的File类构造函数只接受分层结构的URI（比如指向本地文件系统的file:///C:/test.txt这类，有明确的主机、路径层级），而Data URI属于非分层的URI（scheme为data，结构是data:[<mediatype>][;base64],<data>，没有分层的路径信息），所以直接传入File构造函数会触发非法参数异常。

正确的转换步骤 #

要实现转换，核心是先解析Data URI提取出原始内容，再把内容写入本地文件生成File对象，具体分三步：

1. 拆分Data URI，分离元数据（MIME类型、编码方式）和实际内容
2. 根据编码方式解码内容（比如Base64解码）
3. 将解码后的字节写入本地文件，得到File实例

完整示例代码 #

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.net.URISyntaxException;
import java.util.Base64;

public class DataUriConverter {
    public static void main(String[] args) throws URISyntaxException, IOException {
        // 示例：代表txt文件的Data URI
        String dataUri = "data:text/plain;base64,VGVzdGluZy4=";
        
        // 1. 拆分Data URI
        String[] uriSegments = dataUri.split(",");
        String metaInfo = uriSegments[0];
        String encodedContent = uriSegments[1];
        
        // 2. 判断编码方式并解码内容
        byte[] fileContent;
        if (metaInfo.contains(";base64")) {
            // Base64编码的内容，解码成字节数组
            fileContent = Base64.getDecoder().decode(encodedContent);
        } else {
            // 非Base64编码（比如URL编码），直接转字节
            fileContent = encodedContent.getBytes();
        }
        
        // 3. 写入本地文件，生成File对象
        File targetFile = new File("converted_test.txt");
        // 使用try-with-resources自动关闭输出流，避免资源泄漏
        try (FileOutputStream outputStream = new FileOutputStream(targetFile)) {
            outputStream.write(fileContent);
        }
        
        System.out.println("转换完成，文件路径：" + targetFile.getAbsolutePath());
    }
}

额外优化建议 #

• 如果需要根据MIME类型自动设置文件后缀，可以从metaInfo里提取类型：String mimeType = metaInfo.replace("data:", "").split(";")[0];，再映射成对应的后缀（比如text/plain对应.txt）
• 处理大文件时，建议分块解码和写入，避免内存溢出
• 记得捕获并处理IO异常，示例中直接抛出是为了简化，实际项目中要做更友好的异常处理

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