使用multipart/form-data时Spring Controller的modelAttribute为空问题求助

核心原因 #

当表单以multipart/form-data提交时，Spring MVC需要明确的字段来接收上传的文件，若DTO中没有对应MultipartFile类型的字段，会导致整个对象绑定失败，出现modelAttribute为空的情况。

具体解决方案 #

1. 在TestingDTO中添加文件接收字段 #

在你的TestingDTO类里新增MultipartFile类型的属性，用于接收上传的头像，同时添加对应的getter/setter方法：

public class TestingDTO {
    // 其他原有字段...
    
    // 对应表单中的文件上传控件name
    private MultipartFile avatar;

    // getter和setter
    public MultipartFile getAvatar() {
        return avatar;
    }

    public void setAvatar(MultipartFile avatar) {
        this.avatar = avatar;
    }
}

2. 确保表单文件控件与DTO字段名匹配 #

在JSP的表单中，文件上传控件的name属性必须和DTO中新增的MultipartFile字段名一致：

<input type="file" name="avatar" id="avatar">

3. 检查依赖与MultipartResolver配置 #

确保项目中引入了commons-fileupload和commons-io依赖（Maven项目示例）：

<!-- pom.xml -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.11.0</version>
</dependency>

你已配置的CommonsMultipartResolver保持不变即可，注意bean的id必须为multipartResolver，Spring会自动识别这个处理类。

4. 控制器方法无需额外参数 #

你的控制器方法不需要单独添加MultipartFile参数，Spring会自动将上传的文件绑定到TestingDTO的对应字段中，原有方法逻辑可正常使用：

@PostMapping(value = "/save", consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
@Transactional
public ModelAndView save(@ModelAttribute("registerDetails") TestingDTO testingDTO,
                         BindingResult result, ModelAndView model, HttpServletRequest request) throws ServiceProviderException {
    // 直接通过testingDTO.getAvatar()获取上传的文件
    if (!testingDTO.getAvatar().isEmpty()) {
        // 执行文件保存逻辑
    }
    // 其他业务逻辑...
}

额外检查点 #

• 确认DTO中所有需要绑定的普通字段（如用户名、邮箱等）都有对应的getter/setter，且表单控件的name与字段名完全一致。
• 可以通过result.getAllErrors()查看BindingResult中的错误信息，精准定位绑定失败的具体原因。

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