JPA帖子存储疑问：仅input标签名为file时可成功存储的原因

问题场景 #

你使用JPA实现帖子存储功能，当前代码在HTML文件输入的name为file时可以正常工作，但修改为file1或photo等名称时，会触发400 Bad Request错误。相关代码如下：

服务类方法

public void boardWrite(Board board, MultipartFile file) throws Exception, IOException {
    if (!file.isEmpty()) {
        String path = "E:\\image\\sell";
        UUID uuid = UUID.randomUUID();
        String filename = uuid + "_" + file.getOriginalFilename();
        File saveFile = new File(path, filename);
        file.transferTo(saveFile);
        board.setPhoto(filename);
        board.setPhoto_url("/sell/" + filename);
    }

    boardRepository.save(board);
}

控制器代码

@PostMapping("/add")
public String add(Board board, MultipartFile file) throws Exception {
    service.boardWrite(board, file);
    return "redirect:list";
}

HTML文件输入部分

<tr>
    <td width="150" align="center">Photo Attachment</td>
    <td>
        <input type="file" name="file" class="form-control" id="inputGroupFile02">
    </td>
</tr>

核心原因 #

Spring MVC的参数绑定规则依赖请求参数的name属性与控制器方法的参数名称完全匹配：

• 当HTML中文件输入的name为file时，请求会携带名为file的文件参数，Spring能自动将其绑定到控制器方法的MultipartFile file参数上。
• 若修改HTML的name为file1或photo，请求中对应的参数名也会改变，但控制器方法仍在等待名为file的参数。由于该参数默认是必填项，Spring找不到匹配的参数时就会返回400错误，提示请求缺少必填参数。

解决方案 #

你可以通过以下两种方式解决：

1. 保持参数名一致：将HTML文件输入的name属性改回file，与控制器方法的参数名匹配。
2. 显式指定参数映射：使用@RequestParam注解，手动指定请求参数的名称与控制器参数的绑定关系。例如将HTML的name设为photo后，修改控制器方法：

@PostMapping("/add")
public String add(Board board, @RequestParam("photo") MultipartFile file) throws Exception {
    service.boardWrite(board, file);
    return "redirect:list";
}

如果允许用户不上传文件，建议添加required = false，避免无文件时触发错误：

@RequestParam(value = "photo", required = false) MultipartFile file

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