如何在Spring 3.x中向控制器同时发送多文件与表单数据

1. 配置Multipart解析器 #

Spring 3.x不会自动配置文件上传解析器，需要手动配置CommonsMultipartResolver，同时要引入对应依赖包。

依赖配置（Maven） #

在pom.xml中添加以下依赖：

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
</dependency>

XML配置方式 #

在Spring的XML配置文件（如applicationContext.xml或spring-servlet.xml）中添加解析器Bean：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 单个请求最大上传大小，单位字节（示例为10MB） -->
    <property name="maxUploadSize" value="10485760"/>
    <!-- 临时文件存储目录，需确保应用有读写权限 -->
    <property name="uploadTempDir" value="/tmp/spring_uploads"/>
</bean>

Java配置方式（Spring 3.1+支持） #

如果使用Java配置类：

@Configuration
public class WebConfig {
    @Bean
    public CommonsMultipartResolver multipartResolver() {
        CommonsMultipartResolver resolver = new CommonsMultipartResolver();
        resolver.setMaxUploadSize(10485760);
        resolver.setUploadTempDir(new FileSystemResource("/tmp/spring_uploads"));
        return resolver;
    }
}

2. 编写控制器处理请求 #

控制器方法通过@RequestParam绑定文本字段和文件参数，参数名需与表单的name属性完全一致：

@Controller
@RequestMapping("/upload")
public class UploadController {

    @RequestMapping(value = "/submit", method = RequestMethod.POST)
    public String handleFormSubmit(
            @RequestParam("username") String username,
            @RequestParam("description") String description,
            @RequestParam("file1") MultipartFile file1,
            @RequestParam("file2") MultipartFile file2,
            @RequestParam("file3") MultipartFile file3,
            @RequestParam("file4") MultipartFile file4,
            Model model) {

        // 处理文本字段
        System.out.println("用户名: " + username);
        System.out.println("描述: " + description);

        // 批量处理上传文件
        processUploadedFile(file1, "文件1");
        processUploadedFile(file2, "文件2");
        processUploadedFile(file3, "文件3");
        processUploadedFile(file4, "文件4");

        model.addAttribute("message", "表单提交成功");
        return "uploadResult"; // 返回结果页面
    }

    private void processUploadedFile(MultipartFile file, String fileLabel) {
        if (!file.isEmpty()) {
            try {
                // 示例：将文件保存到指定目录
                String savePath = "/path/to/your/upload/dir/" + file.getOriginalFilename();
                file.transferTo(new File(savePath));
                System.out.println(fileLabel + " 上传成功：" + savePath);
            } catch (IOException e) {
                e.printStackTrace();
                System.err.println(fileLabel + " 上传失败");
            }
        } else {
            System.err.println(fileLabel + " 为空，跳过处理");
        }
    }
}

3. 前端表单示例 #

表单必须设置enctype="multipart/form-data"，否则无法正确上传文件：

<form action="/upload/submit" method="post" enctype="multipart/form-data">
    <div>
        <label>用户名:</label>
        <input type="text" name="username" required>
    </div>
    <div>
        <label>描述:</label>
        <textarea name="description" rows="3"></textarea>
    </div>
    <div>
        <label>文件1:</label>
        <input type="file" name="file1" required>
    </div>
    <div>
        <label>文件2:</label>
        <input type="file" name="file2">
    </div>
    <div>
        <label>文件3:</label>
        <input type="file" name="file3">
    </div>
    <div>
        <label>文件4:</label>
        <input type="file" name="file4">
    </div>
    <button type="submit">提交表单</button>
</form>

关键注意事项 #

• 确保上传目录和临时目录的读写权限，避免文件写入失败。
• 如果上传文件大小超过配置的maxUploadSize，会抛出MaxUploadSizeExceededException，可通过全局异常处理器捕获并返回友好提示。
• 依赖版本需与Spring 3.x兼容，上述示例中的版本经过验证可正常使用。

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