Spring Boot 3中@Valid与@RequestPart结合校验失效问题求助

错误原因 #

你遇到的错误核心在于：Spring 要求Errors/BindingResult参数必须紧跟在需要数据绑定的目标参数之后，但MultipartFile作为@RequestPart参数时，Spring不会为它自动创建BindingResult上下文——它是直接从请求中解析的文件对象，而非需要进行属性绑定的JavaBean，所以直接声明Errors参数不符合Spring的参数处理规则。而@RequestBody对应JSON转JavaBean的绑定过程，Spring会自动生成BindingResult，因此那种场景下可以正常运行。

解决方案 #

方案1：手动调用校验器（快速适配现有代码） #

去掉方法参数中的Errors，在方法内部手动实例化BindingResult并调用校验器：

修改控制器的upload方法：

@PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
@ResponseStatus(HttpStatus.CREATED)
public ResourceIdDto upload(@RequestPart("file") MultipartFile multipartFile) {
    // 手动创建BindingResult实例
    BindingResult bindingResult = new BeanPropertyBindingResult(multipartFile, "file");
    Mp3FileValidator validator = new Mp3FileValidator();
    validator.validate(multipartFile, bindingResult);
    
    checkErrors(bindingResult);
    
    byte[] bytes;
    try {
        bytes = multipartFile.getBytes();
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
    return resourceService.upload(bytes);
}

同时可以删除@InitBinder中针对MultipartFile的校验器注册逻辑，因为现在是手动触发校验。

方案2：封装文件到自定义DTO（适配Spring绑定规则） #

创建一个包含MultipartFile的DTO类，让Spring为其创建绑定上下文，即可正常使用@Valid和BindingResult：

1. 定义文件上传DTO：

public class FileUploadDto {
    private MultipartFile file;

    // getter & setter
    public MultipartFile getFile() {
        return file;
    }

    public void setFile(MultipartFile file) {
        this.file = file;
    }
}

2. 调整控制器方法：

@PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
@ResponseStatus(HttpStatus.CREATED)
public ResourceIdDto upload(@RequestPart("file") @Valid FileUploadDto fileUploadDto, BindingResult bindingResult) {
    checkErrors(bindingResult);
    
    MultipartFile multipartFile = fileUploadDto.getFile();
    byte[] bytes;
    try {
        bytes = multipartFile.getBytes();
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
    return resourceService.upload(bytes);
}

3. 修改校验器适配DTO：

public class Mp3FileValidator implements Validator {
    @Override
    public boolean supports(Class<?> clazz) {
        return FileUploadDto.class.equals(clazz);
    }

    @Override
    public void validate(Object target, Errors errors) {
        FileUploadDto dto = (FileUploadDto) target;
        MultipartFile multipartFile = dto.getFile();
        if (multipartFile.isEmpty()) {
            errors.rejectValue("file", "Sent file is empty");
            return;
        }
        Tika tika = new Tika();
        try {
            String detectedType = tika.detect(multipartFile.getInputStream());
            boolean isMp3 = "audio/mpeg".equals(detectedType);
            if (!isMp3) {
                errors.rejectValue("file", "This isn't mp3 file");
            }
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
}

方案3：自定义校验注解（推荐，符合Spring Validation规范） #

创建针对MultipartFile的自定义校验注解，无需依赖Errors参数，更符合Spring Boot最佳实践：

1. 定义校验注解：

@Target({ElementType.PARAMETER, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = Mp3FileValidator.class)
public @interface ValidMp3File {
    String message() default "Invalid MP3 file";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 修改校验器实现ConstraintValidator：

public class Mp3FileValidator implements ConstraintValidator<ValidMp3File, MultipartFile> {
    @Override
    public boolean isValid(MultipartFile multipartFile, ConstraintValidatorContext context) {
        if (multipartFile.isEmpty()) {
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate("Sent file is empty")
                   .addConstraintViolation();
            return false;
        }
        Tika tika = new Tika();
        try {
            String detectedType = tika.detect(multipartFile.getInputStream());
            boolean isMp3 = "audio/mpeg".equals(detectedType);
            if (!isMp3) {
                context.disableDefaultConstraintViolation();
                context.buildConstraintViolationWithTemplate("This isn't mp3 file")
                       .addConstraintViolation();
                return false;
            }
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
        return true;
    }
}

3. 简化控制器方法：

@PostMapping(consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
@ResponseStatus(HttpStatus.CREATED)
public ResourceIdDto upload(@RequestPart("file") @ValidMp3File MultipartFile multipartFile) {
    // 校验不通过时Spring自动抛出MethodArgumentNotValidException，可全局捕获处理
    byte[] bytes;
    try {
        bytes = multipartFile.getBytes();
    } catch (IOException e) {
        throw new RuntimeException(e);
    }
    return resourceService.upload(bytes);
}

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