SpringBoot+Thymeleaf表单上传MultipartFile报错及文件为空求解

1. 修正Thymeleaf表单的enctype属性 #

带文件上传的表单必须指定enctype="multipart/form-data"，否则浏览器默认使用application/x-www-form-urlencoded编码，后端无法解析文件，直接触发类型不支持异常。修改表单代码如下：

<form method="post" th:action="@{/interview/create}" enctype="multipart/form-data">
    <!-- 其他业务字段输入框，如姓名、面试时间等 -->
    <input type="file" name="curriculum" accept=".pdf" />
    <button type="submit">提交</button>
</form>

注意：name属性值必须与DTO中的文件字段名完全一致（此处为curriculum）。

2. 调整CreateInterviewTO DTO的文件字段配置 #

DTO中的文件字段需使用MultipartFile类型，确保Spring能正确绑定上传的文件对象，示例代码：

public class CreateInterviewTO {
    // 其他常规业务字段，如private String applicantName; private LocalDate interviewDate;
    private MultipartFile curriculum;

    // 对应的getter/setter方法
    public MultipartFile getCurriculum() {
        return curriculum;
    }

    public void setCurriculum(MultipartFile curriculum) {
        this.curriculum = curriculum;
    }
}

3. 修正InterviewController的接口注解 #

接口需支持multipart请求，使用@ModelAttribute绑定DTO（或单独用@RequestPart接收文件），示例代码：

@RestController
@RequestMapping("/interview")
public class InterviewController {

    @PostMapping("/create")
    public ResponseEntity<String> createInterview(@ModelAttribute CreateInterviewTO interviewTO) {
        // 处理文件上传逻辑
        if (!interviewTO.getCurriculum().isEmpty()) {
            // 示例：将文件保存到本地
            // String originalFileName = interviewTO.getCurriculum().getOriginalFilename();
            // interviewTO.getCurriculum().transferTo(new File("/your/save/path/" + originalFileName));
        }
        // 其他业务逻辑处理
        return ResponseEntity.ok("提交成功");
    }
}

如果是传统Spring MVC项目，需确保已配置MultipartResolver；Spring Boot项目则无需手动配置，spring-boot-starter-web依赖已包含自动配置。

4. 排查常见问题 #

• 确认表单请求方式为POST，GET请求不支持文件上传。
• 检查DTO字段名与表单name属性大小写完全匹配（Java字段名与表单name遵循驼峰/下划线自动映射规则，若不一致需手动指定）。
• 若上传文件过大，需调整Spring Boot配置：

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

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