Ajax实现文件上传功能(Spring MVC)

Ajax实现文件上传功能详解与Spring MVC代码实例

今天，咱们来聊聊一个在Web开发中既基础又高频的需求——通过Ajax实现文件上传。很多开发者在初次接触时，可能会在处理表单数据和服务器接收上遇到点小麻烦。别担心，下面这个完整的Spring MVC示例，或许能帮你理清思路。

前端表单与JQuery引入

前端的准备工作很简单。首先，别忘了引入jQuery库，毕竟用它来处理Ajax请求会方便不少。

接着，构建一个基础的文件上传表单。关键在于 enctype="multipart/form-data" 这个属性，它告诉浏览器以多部分表单数据的形式上传文件，而不是普通的表单编码。

 
请选择要上传的文件：
 

 

核心环节：Ajax请求构造

重头戏在这里。如何将表单数据通过Ajax发送出去？重点在于正确处理 FormData 对象以及jQuery的Ajax配置项。

这里有两点特别需要注意：将 processData 设置为 false，是为了防止jQuery将 FormData 对象转换为字符串；将 contentType 设置为 false，是为了让浏览器自动设置正确的请求头（即包含边界信息的 multipart/form-data），jQuery如果自作主张地设置，反而会破坏文件上传的数据结构。

服务端接收：Spring MVC控制器

前端数据送出去了，后端怎么接？在Spring MVC框架下，借助 CommonsMultipartFile 来接收文件流是非常便捷的做法。

@PostMapping("/upload")
public void fileUpload2(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request) throws IOException {
 System.out.println("走了");
 //上传路径保存设置
 String path = request.getServletContext().getRealPath("/upload");
 File realPath = new File(path);
 if (!realPath.exists()) {
  realPath.mkdir();
 }
 //上传文件地址
 System.out.println("上传文件保存地址：" + realPath);
 //通过CommonsMultipartFile的方法直接写文件（注意这个时候）
 file.transferTo(new File(realPath + "/" + file.getOriginalFilename()));
}

这段代码的逻辑很清晰：先获取服务器上用于存储上传文件的物理路径，如果目录不存在则创建它。然后，直接调用 transferTo 方法，将接收到的文件写入到指定的目录中。在实际项目中，你很可能还需要添加文件名处理、文件大小校验、文件类型过滤等逻辑来增强安全性。

运行结果展示

当这一切都配置正确后，点击前端的“上传”按钮，文件就会被异步提交到服务器并保存。整个过程页面无需刷新，用户体验非常流畅。

希望这个从前端到后端的完整流程解析，能帮助你牢固掌握Ajax文件上传的实现要点。多动手实践几遍，这个技术点就彻底拿下了。