Spring Boot表单文件上传报错：Validation failed for argument [0]

尝试通过表单保存药品信息（含文本、文件名）并上传文件到指定文件夹，已实现MedRx实体类、控制器、表单及文件上传服务，但提交表单时触发MethodArgumentNotValidException，提示无法将MultipartFile类型转换为MedRx实体中String类型的icon和pic字段。

实体类MedRx #

package com.rx.healthtechhub.entities;

import java.util.Date;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.format.annotation.DateTimeFormat.ISO;
import jakarta.persistence.CascadeType;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.persistence.JoinColumn;
import jakarta.persistence.ManyToOne;
import jakarta.persistence.Table;

@Entity
@Table(name = "medrx")
public class MedRx {
    @Id
    @Column(name = "id_medrx")
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int idMedrx;
    private String nameMed;
    @Column(columnDefinition = "TEXT")
    private String icon;
    @Column(columnDefinition = "TEXT")
    private String pic;
    @ManyToOne(cascade = CascadeType.ALL)
    @JoinColumn(name = "id_medrxgroup")
    private MedRxGroups medRxGroups;
    @ManyToOne(cascade = CascadeType.ALL)
    @JoinColumn(name = "id_manufacturer")
    private Manufacturer manufacturer;
    private String packSize;
    private Double unitPrice;
    @DateTimeFormat(iso = ISO.DATE_TIME)
    private Date lastUpdate;
    @DateTimeFormat(iso = ISO.DATE_TIME)
    private Date createDate;
    public MedRx() {}
    // 省略getter、setter及toString方法
}

控制器代码 #

@PostMapping("/add_medrx")
public String saveMedRxPg(@ModelAttribute("medRx") MedRx medRx, 
                           @RequestParam("icon") MultipartFile icon, 
                           @RequestParam("pic") MultipartFile pic, 
                           Model model, RedirectAttributes redirectAttributes) {
    String msg;
    try {
        String newIcon = fileUploadService.save(icon);
        String newPic = fileUploadService.save(pic);
        medRx.setCreateDate(new Date());
        medRx.setLastUpdate(new Date());
        medRx.setIcon(newIcon);
        medRx.setPic(newPic);
        medRxService.addMedRx(medRx);
        msg = "Files uploaded successfully!";
        redirectAttributes.addFlashAttribute("message", msg);
    } catch (Exception e) {
        msg = "Could not upload the files. Error: " + e.getMessage();
        redirectAttributes.addFlashAttribute("message", msg);
    }
    return "redirect:/admin/medicines";
}
// 省略其他控制器方法

表单代码 #

<form class="form-horizontal" th:action="@{/add_medrx}" enctype="multipart/form-data" method="post" th:object="${medrx}">
    <!-- 省略表单其他内容 -->
    <div class="form-group">
        <label class="col-md-3 col-xs-12 control-label">Icon</label>
        <div class="col-md-6 col-xs-12">
            <input type="file" id="icon" name="icon" class="fileinput btn-primary" title="Browse file" />
        </div>
    </div>
    <div class="form-group">
        <label class="col-md-3 col-xs-12 control-label">Picture</label>
        <div class="col-md-6 col-xs-12">
            <input type="file" id="pic" name="pic" class="fileinput btn-primary" title="Browse file" />
        </div>
    </div>
    <!-- 省略表单其他内容 -->
</form>

文件上传服务代码 #

FileUploadService接口

package com.rx.healthtechhub.services;
import java.nio.file.Path;
import java.util.stream.Stream;
import org.springframework.core.io.Resource;
import org.springframework.web.multipart.MultipartFile;
public interface FileUploadService {
    public void init();
    public String save(MultipartFile file);
    public Resource load(String filename);
    public void deleteAll();
    public Stream<Path> loadAll();
}

FilesStorageServiceImpl实现类

package com.rx.healthtechhub.services;
import java.io.IOException;
import java.net.MalformedURLException;
import java.nio.file.FileAlreadyExistsException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.UUID;
import java.util.stream.Stream;
import org.springframework.core.io.Resource;
import org.springframework.core.io.UrlResource;
import org.springframework.stereotype.Service;
import org.springframework.util.FileSystemUtils;
import org.springframework.web.multipart.MultipartFile;
@Service
public class FilesStorageServiceImpl implements FileUploadService {
    private final Path root = Paths.get("./src/main/resources/static/img/uploads/");
    @Override
    public void init() {
        try {
            Files.createDirectories(root);
        } catch (IOException e) {
            throw new RuntimeException("Could not initialize folder for upload!");
        }
    }
    @Override
    public String save(MultipartFile file) {
        try {
            String newFileName = generateNewFileName(file.getOriginalFilename());
            Files.copy(file.getInputStream(), this.root.resolve(newFileName));
            return newFileName;
        } catch (Exception e) {
            if (e instanceof FileAlreadyExistsException) {
                throw new RuntimeException("A file of that name already exists.");
            }
            throw new RuntimeException(e.getMessage());
        }
    }
    private String generateNewFileName(String originalFilename) {
        String extension = originalFilename.substring(originalFilename.lastIndexOf('.'));
        String dateTime = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMddHHmmss"));
        String randomId = UUID.randomUUID().toString().replace("-", "");
        return "manufacturer_" + dateTime + "_" + randomId + extension;
    }
    // 省略其他方法实现
}

错误日志 #

[2m2024-06-18T12:17:29.770+06:00[0;39m [33m WARN[0;39m [35m6836[0;39m [2m---[0;39m [2m[rx.healthtechhub.co] [nio-8080-exec-9][0;39m [2m[0;39m[36m.w.s.m.s.DefaultHandlerExceptionResolver[0;39m [2m:[0;39m Resolved [org.springframework.web.bind.MethodArgumentNotValidException: Validation failed for argument [0] in public java.lang.String com.rx.healthtechhub.controller.HomeController.saveMedRxPg(com.rx.healthtechhub.entities.MedRx,org.springframework.web.multipart.MultipartFile,org.springframework.web.multipart.MultipartFile,org.springframework.ui.Model,org.springframework.web.servlet.mvc.support.RedirectAttributes) with 2 errors: [Field error in object 'medRx' on field 'icon': rejected value [org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile@3c008fd6]; codes [typeMismatch.medRx.icon,typeMismatch.icon,typeMismatch.java.lang.String,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [medRx.icon,icon]; arguments []; default message [icon]]; default message [Failed to convert property value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'java.lang.String' for property 'icon'; Cannot convert value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'java.lang.String' for property 'icon': no matching editors or conversion strategy found]] [Field error in object 'medRx' on field 'pic': rejected value [org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile@5321c0cb]; codes [typeMismatch.medRx.pic,typeMismatch.pic,typeMismatch.java.lang.String,typeMismatch]; arguments [org.springframework.context.support.DefaultMessageSourceResolvable: codes [medRx.pic,pic]; arguments []; default message [pic]]; default message [Failed to convert property value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'java.lang.String' for property 'pic'; Cannot convert value of type 'org.springframework.web.multipart.support.StandardMultipartHttpServletRequest$StandardMultipartFile' to required type 'java.lang.String' for property 'pic': no matching editors or conversion strategy found]] ]

问题根源分析 #

表单使用th:object="${medrx}"绑定MedRx对象时，Spring会自动将表单中所有同名参数绑定到实体类字段。由于文件输入框的name属性（icon、pic）与MedRx实体的String类型字段同名，Spring尝试将MultipartFile类型的文件参数直接赋值给String字段，导致类型转换失败。即使控制器中单独声明了@RequestParam接收文件，Spring会先完成@ModelAttribute的绑定逻辑，此时已触发类型不匹配错误。

修复方案 #

方案1：修改表单字段名（推荐） #

将表单中文件输入框的name属性改为与实体类字段不同的名称，避免自动绑定冲突，同时更新控制器的@RequestParam参数名：

• 表单修改：

<input type="file" id="icon" name="iconFile" class="fileinput btn-primary" title="Browse file" />
<input type="file" id="pic" name="picFile" class="fileinput btn-primary" title="Browse file" />

• 控制器修改：

@PostMapping("/add_medrx")
public String saveMedRxPg(@ModelAttribute("medRx") MedRx medRx, 
                           @RequestParam("iconFile") MultipartFile icon, 
                           @RequestParam("picFile") MultipartFile pic, 
                           Model model, RedirectAttributes redirectAttributes) {
    // 原有业务逻辑保持不变
}

方案2：实体类字段添加@Transient（不推荐） #

若不想修改表单字段名，可在MedRx的icon、pic字段上添加@Transient注解，让Spring绑定@ModelAttribute时忽略这两个字段，但该注解会让JPA忽略字段的数据库持久化，需额外调整逻辑才能正常存储，因此仅作为备选：

@Transient
@Column(columnDefinition = "TEXT")
private String icon;
@Transient
@Column(columnDefinition = "TEXT")
private String pic;

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