SpringBoot返回MultipartFile出现无效JSON，如何修复？

直接返回MultipartFile会触发Jackson自动序列化，但MultipartFile是Spring为接收上传文件设计的接口，它的实现类（比如MockMultipartFile）中的inputStream属于不可序列化的资源，Jackson无法正确处理该字段，最终生成的JSON会包含无效的"inputStream"字段，导致客户端$.ajax解析JSON时报错。

推荐以下两种合理的返回方式：

方法1：直接返回字节数组 #

读取文件流为字节数组，配合正确的响应头返回，Spring会自动处理成文件流响应：

import org.apache.commons.io.IOUtils;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.http.ContentDisposition;

// ...

InputStream inputStream = imageUploadResponse.getInputStream();
byte[] fileBytes = IOUtils.toByteArray(inputStream); // 将流读取为字节数组

HttpHeaders headers = new HttpHeaders();
// 设置文件MIME类型
headers.setContentType(MediaType.parseMediaType(imageUploadResponse.getMimeType()));
// 设置下载文件名（可选，若需要浏览器直接触发下载）
headers.setContentDisposition(ContentDisposition.builder("attachment")
        .filename(imageUploadResponse.getKey())
        .build());

return new ResponseEntity<>(fileBytes, headers, HttpStatus.OK);

方法2：使用Spring Resource返回 #

用ByteArrayResource包装字节数组，Spring会自动处理响应序列化，避免无效字段：

import org.apache.commons.io.IOUtils;
import org.springframework.core.io.ByteArrayResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.http.ContentDisposition;

// ...

InputStream inputStream = imageUploadResponse.getInputStream();
byte[] fileBytes = IOUtils.toByteArray(inputStream);
ByteArrayResource resource = new ByteArrayResource(fileBytes);

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.parseMediaType(imageUploadResponse.getMimeType()));
headers.setContentDisposition(ContentDisposition.builder("attachment")
        .filename(imageUploadResponse.getKey())
        .build());

return new ResponseEntity<>(resource, headers, HttpStatus.OK);

客户端适配 #

因为现在返回的是二进制文件流而非JSON，需要修改$.ajax的responseType为blob才能正确解析：

$.ajax({
    url: "/your/api/path",
    method: "GET",
    responseType: "blob", // 关键：指定接收二进制流
    success: function(blob) {
        // 示例：触发文件下载
        const downloadUrl = window.URL.createObjectURL(blob);
        const aTag = document.createElement("a");
        aTag.href = downloadUrl;
        aTag.download = "your-filename.ext"; // 替换为实际文件名
        document.body.appendChild(aTag);
        aTag.click();
        // 清理资源
        window.URL.revokeObjectURL(downloadUrl);
        document.body.removeChild(aTag);
    },
    error: function(xhr) {
        console.error("文件获取失败", xhr);
    }
});

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