Spring MVC 默认将 MultipartFile 方法参数名（如 file）作为 HTTP 表单中 的 name 属性值进行绑定；若不一致，将因参数解析失败导致 400 错误。

spring mvc 默认将 `multipartfile` 方法参数名（如 `file`）作为 http 表单中 `` 的 `name` 属性值进行绑定；若不一致，将因参数解析失败导致 400 错误。

在 Spring Boot + JPA 的 Web 应用中，MultipartFile 类型的控制器方法参数默认遵循 “按名称自动绑定” 规则：Spring 会尝试将 HTTP 请求中 name 属性值与 Java 方法参数名完全匹配的文件字段注入到该参数中。

例如，控制器方法定义为：

@PostMapping("/add")
public String add(Board board, MultipartFile file) { ... }

此处参数名为 file，Spring 就会查找请求中 name="file" 的 <input type="file"> 字段。若 HTML 中写成：

<input type="file" name="photo" ...>

则 Spring 找不到 name="file" 的文件项，file 参数被解析为 null（或空 MultipartFile），同时由于 MultipartFile 默认 required=true，最终触发 MethodArgumentNotValidException 或直接返回 HTTP 400 Bad Request。

✅ 正确做法有三种：

1. 保持 HTML name 与参数名一致（最简方式）：

   <input type="file" name="file" class="form-control">

2. 显式指定 @RequestParam 名称（推荐，语义清晰）：

   @PostMapping("/add")
   public String add(Board board, @RequestParam("photo") MultipartFile photo) throws Exception {
       service.boardWrite(board, photo); // 注意：需同步修改 service 方法签名
       return "redirect:list";
   }

   同时更新服务层方法以匹配新参数名：

   public void boardWrite(Board board, MultipartFile photo) throws Exception, IOException {
       if (!photo.isEmpty()) { // 变量名同步更新
           // ... 保存逻辑不变
       }
       boardRepository.save(board);
   }

3. 支持多名称兼容（高级场景）：
   使用 @PostMapping(params = "...") 分离不同入口，统一委托处理：

   @PostMapping(value = "/add", params = "photo")
   public String addWithPhoto(@RequestParam("photo") MultipartFile photo, Board board) {
       return processBoardSubmission(board, photo);
   }
   
   @PostMapping(value = "/add", params = "file")
   public String addWithFile(@RequestParam("file") MultipartFile file, Board board) {
       return processBoardSubmission(board, file);
   }
   
   private String processBoardSubmission(Board board, MultipartFile file) {
       try {
           service.boardWrite(board, file);
       } catch (Exception e) {
           throw new RuntimeException("文件保存失败", e);
       }
       return "redirect:list";
   }

⚠️ 注意事项：

• MultipartFile 参数默认 required=true，若表单无对应 name 字段，必然报错；如需可选上传，须显式声明 @RequestParam(required = false)。
• Board board 参数通过 @ModelAttribute 自动绑定，其字段名需与表单 name 匹配（如 <input name="title"> → board.setTitle(...)），但与文件字段名无关。
• 前端务必设置表单 enctype="multipart/form-data"，否则文件无法传输：

掌握这一绑定机制，不仅能解决 name="file" 的硬编码依赖，还能构建更灵活、可维护的文件上传接口。