如何在Spring MVC中自动映射POST参数至POJO对象？

你猜的没错，用@RequestBody报错的核心原因就是multipart/form-data格式的表单请求体并非JSON，而@RequestBody默认是用来解析JSON/XML这类结构化请求体的，自然没法处理普通表单参数。下面是把表单参数自动映射到POJO的最佳实践：

核心思路：用表单参数绑定而非请求体解析 #

Spring对表单提交的参数有原生的绑定支持，完全不需要依赖@RequestBody，直接把POJO作为方法参数（或配合@ModelAttribute注解）即可，前提满足以下几点：

• POJO类必须有无参构造器
• 表单中输入字段的name属性和POJO的字段名完全匹配
• 字段提供对应的getter/setter方法

方案1：直接将POJO作为方法参数 #

如果你的表单包含普通输入字段和文件，可以分开处理普通参数和文件：

@RequestMapping(value="/uploadAttachment.spr", consumes = "multipart/form-data", method = RequestMethod.POST)
public String execute(AttachmentFormModel model, 
                      @RequestParam("attachmentFile") MultipartFile file, // 对应表单文件输入的name属性
                      HttpServletResponse response) {
    // model已自动填充所有普通表单参数
    String submitter = model.getSubmitter();
    String fileDesc = model.getFileDescription();
    
    // 处理上传文件
    if (!file.isEmpty()) {
        String originalName = file.getOriginalFilename();
        // ... 执行文件保存逻辑
    }
    return "success";
}

方案2：在POJO中直接包含MultipartFile字段 #

如果想把文件也统一纳入POJO管理，可以在AttachmentFormModel中添加MultipartFile类型的字段，确保字段名和表单文件输入的name一致：

public class AttachmentFormModel {
    private String submitter;
    private String fileDescription;
    private MultipartFile attachmentFile; // 和表单file输入的name属性完全匹配

    // 必须有无参构造器
    public AttachmentFormModel() {}

    // 所有字段的getter/setter方法
    // ...
}

此时Controller方法可以简化为：

@RequestMapping(value="/uploadAttachment.spr", consumes = "multipart/form-data", method = RequestMethod.POST)
public String execute(@ModelAttribute AttachmentFormModel model, HttpServletResponse response) {
    // 直接从model获取所有参数和文件
    MultipartFile uploadFile = model.getAttachmentFile();
    // ... 业务处理逻辑
}

关键配置：启用Multipart解析 #

要让Spring正常处理文件上传，必须配置Multipart解析器：

传统XML配置 #

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="5242880"/> <!-- 限制最大上传大小为5MB -->
</bean>

Spring Boot 配置（自动配置简化版） #

Spring Boot默认已经自动配置了Multipart解析器，如需自定义参数，直接在application.properties中设置：

spring.servlet.multipart.max-file-size=5MB
spring.servlet.multipart.max-request-size=10MB

额外注意 #

• 你的Dojo提交代码不需要做任何修改，dojo.io.iframe.send已经正确发送了multipart/form-data格式的请求
• 如果表单参数名和POJO字段名无法匹配，可以在字段上用@RequestParam指定映射关系，不过更推荐保持表单name和字段名一致，减少额外配置

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