使用FormData发起Ajax请求时遭遇415错误的排查求助

DevOps 小满

2026-8-23

解决FormData上传文件返回415错误的问题

前端代码问题修复

上传多个文件时，不能直接将数组传给FormData的append方法，需要对每个文件单独调用append并保持key一致：

var file = picChooser.files[0];

var jobExecutionImagesContext = new FormData();
// 正确添加多个文件
jobExecutionImagesContext.append('file', file);
jobExecutionImagesContext.append('file', file);
jobExecutionImagesContext.append('apptId', '123456789rt78');
jobExecutionImagesContext.append('keyPrefix','images/start');

var request =  new XMLHttpRequest();
request.open('POST', "/example/images", true);
// 无需手动设置Content-Type，XMLHttpRequest会自动处理multipart/form-data并添加boundary分隔符
request.addEventListener('error', function(response) {console.log("failed ajax call: {}", response); }, false);
request.addEventListener('load', function(response) {console.log("suceeded ajax call: {}", response);}, false);
request.addEventListener('abort', function(response) {console.log("failed ajax call: {}", response); }, false);
request.send(jobExecutionImagesContext);

后端代码问题修复

415错误核心原因是后端控制器未声明支持multipart/form-data媒体类型，同时缺少文件参数的正确绑定：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;

@PostMapping(value = "/example/images", consumes = "multipart/form-data")
public @ResponseBody String capturePhotos(
        @RequestParam("file") MultipartFile[] files,
        @RequestParam("apptId") String apptId,
        @RequestParam("keyPrefix") String keyPrefix) {
    // 在这里编写文件和参数的处理逻辑
    return "success";
}