Spring+Thymeleaf表单如何同时接收普通数据与Multipart文件？

要实现表单同时提交普通输入项和文件，需从前端表单、后端实体类、接口逻辑三部分修改：

1. 修改前端Thymeleaf表单 #

表单必须添加enctype="multipart/form-data"属性，否则无法上传文件；同时修正文件输入框的校验字段，与表单name属性保持一致：

<form class="inp-form" id="insertInterview" action="#" th:action="@{/interview/create}" th:object="${createInterviewTO}" method="post" enctype="multipart/form-data">
       <div class="form-group">
              <div class="2-column-container">
                     <div class="row">
                         <div class="column">
                               <div class="form-group">
                                        <label>Name</label>
                                           <input type="text" th:field="*{candidateName}" placeholder="Name" />
                                                    <small th:if="${#fields.hasErrors('candidateName')}" th:errors="*{candidateName}">Name Error</small>
                                                </div>
                                            </div>
                                            <div class="column">
                                                <div class="form-group">
                                                    <label>Surname</label>
                                                    <input type="text" th:field="*{candidateSurname}" placeholder="Surname" />
                                                    <small th:if="${#fields.hasErrors('candidateSurname')}" th:errors="*{candidateSurname}">Surname Error</small>
                                                </div>
                                            </div>

                                            <div class="column">
                                                <div class="form-group">
                                                    <label>Curriculum</label>
                                                    <input type="file" id="cv" name="curriculum" accept="pdf" />
                                                    <small th:if="${#fields.hasErrors('curriculum')}" th:errors="*{curriculum}">CV Error</small>
                                                </div>
                                            </div>
</form>

2. 更新CreateInterviewTO实体类 #

添加MultipartFile类型的字段，字段名需与表单中文件输入框的name属性（即curriculum）一致，并生成对应的getter/setter方法：

public class CreateInterviewTO {
    private String candidateName;
    private String candidateSurname;
    // 新增文件字段，对应表单的name="curriculum"
    private MultipartFile curriculum;

    // 普通字段的getter/setter
    public String getCandidateName() {
        return candidateName;
    }

    public void setCandidateName(String candidateName) {
        this.candidateName = candidateName;
    }

    public String getCandidateSurname() {
        return candidateSurname;
    }

    public void setCandidateSurname(String candidateSurname) {
        this.candidateSurname = candidateSurname;
    }

    // 文件字段的getter/setter
    public MultipartFile getCurriculum() {
        return curriculum;
    }

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

3. 调整后端接口逻辑 #

必须移除@RequestBody注解（该注解仅用于接收JSON格式数据，无法处理表单的multipart请求），通过@ModelAttribute接收完整的表单数据，包括文件：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;

@PostMapping("/create")
public ResponseEntity<Object> createInterview(@ModelAttribute CreateInterviewTO createInterviewTO) {
    // 处理普通输入字段
    String candidateName = createInterviewTO.getCandidateName();
    String candidateSurname = createInterviewTO.getCandidateSurname();

    // 处理上传的文件
    MultipartFile cvFile = createInterviewTO.getCurriculum();
    if (cvFile != null && !cvFile.isEmpty()) {
        String fileName = cvFile.getOriginalFilename();
        // 示例：将文件保存到本地指定目录
        try {
            cvFile.transferTo(new File("/your/save/path/" + fileName));
        } catch (IOException e) {
            e.printStackTrace();
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("简历文件保存失败");
        }
    }

    // 执行其他业务逻辑（如保存到数据库等）
    return ResponseEntity.ok("面试信息创建成功");
}

备选方案：单独接收文件 #

如果不想将文件字段放入CreateInterviewTO，也可以通过@RequestParam单独接收文件：

@PostMapping("/create")
public ResponseEntity<Object> createInterview(
        @ModelAttribute CreateInterviewTO createInterviewTO,
        @RequestParam("curriculum") MultipartFile curriculum) {
    // 处理逻辑与上述一致，直接使用curriculum变量即可
    return ResponseEntity.ok("面试信息创建成功");
}

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