Spring Boot中如何将List<MultipartFile>转换为Base64格式？

核心思路 #

把MultipartFile的字节流直接转换为Base64编码字符串，替代或补充原有的本地文件保存逻辑，根据实际需求选择仅存Base64、同时保存文件和Base64，或是返回Base64给前端。

代码改造步骤 #

1. 服务层新增Base64转换逻辑 #

修改服务层代码，添加转换方法并调整保存逻辑：

import java.util.Base64;
import java.util.List;
import java.util.ArrayList;

// 若需保留本地文件保存，可保留原有rootFolder定义
private final Path rootFolder = Paths.get("upload");

// 单个文件转Base64的工具方法
private String convertToBase64(MultipartFile file) throws Exception {
    byte[] fileBytes = file.getBytes();
    return Base64.getEncoder().encodeToString(fileBytes);
}

@Override
public void save(MultipartFile file) throws Exception {
    // 可选：保留本地文件保存逻辑，不需要可删除
    Files.copy(file.getInputStream(), this.rootFolder.resolve(file.getOriginalFilename()));
    
    // 转换为Base64，此处替换为你的实际处理逻辑（如存入数据库、写入配置文件等）
    String base64Str = convertToBase64(file);
    System.out.println("文件[" + file.getOriginalFilename() + "]的Base64编码：" + base64Str);
}

@Override
public void save(List<MultipartFile> files) throws Exception {
    for(MultipartFile file: files){
        this.save(file);
    }
}

2. 控制器调整（可选：返回Base64给前端） #

如果需要将Base64字符串返回给调用方，可修改控制器和服务层的返回逻辑：

控制器代码

@PostMapping("/upload")
public ResponseEntity<Response> uploadFiles(@RequestParam("files") List<MultipartFile> files) throws Exception { 
    // 调用服务层方法获取所有文件的Base64列表
    List<String> base64List = fileServiceAPI.saveAndReturnBase64(files);
    // 构造包含Base64的响应（需确保Response类支持添加base64List字段）
    Response response = new Response("文件已成功转换为Base64格式");
    response.setBase64List(base64List);
    return ResponseEntity.status(HttpStatus.OK).body(response);
}

服务层新增对应方法

public List<String> saveAndReturnBase64(List<MultipartFile> files) throws Exception {
    List<String> base64List = new ArrayList<>();
    for(MultipartFile file: files){
        // 可选：保留本地文件保存
        Files.copy(file.getInputStream(), this.rootFolder.resolve(file.getOriginalFilename()));
        // 转换并收集Base64
        String base64Str = convertToBase64(file);
        base64List.add(base64Str);
        // 同时可将Base64存入数据库等持久化存储
    }
    return base64List;
}

注意事项 #

• Base64编码会让文件体积增大约30%，处理大文件时需评估存储或传输的资源消耗。
• 如果仅用于文件存储，直接保存原始字节流比Base64更高效；Base64更适合在JSON等文本协议中传输二进制数据。

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