Spring中@RequestPart结合自定义验证注解不生效问题求助

问题本质 #

Spring的@Valid注解默认仅对复杂Java对象（如带字段的POJO）生效，因为验证机制依赖数据绑定到对象的逻辑。对于@RequestPart或@RequestParam直接接收的MultipartFile这类简单类型，Spring不会自动触发验证器——哪怕你加了@Valid也没用，这就是日志里验证器未被调用的原因。

可行解决方案（适配混合内容场景） #

方案1：手动调用验证器（最简单直接） #

在接口方法中注入Validator，拿到MultipartFile后手动触发验证，校验不通过则抛出异常。

示例代码：

import org.springframework.validation.Validator;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestPart;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import jakarta.validation.Valid;
import jakarta.validation.ConstraintViolation;
import java.util.Set;

@RestController
public class FileUploadController {

    private final Validator validator;

    public FileUploadController(Validator validator) {
        this.validator = validator;
    }

    @PostMapping(value = "/upload", consumes = {"multipart/form-data"})
    public String upload(
            @RequestPart("custom_file") @Valid @FileContentType(MediaType.APPLICATION_PDF_VALUE) MultipartFile file,
            @RequestPart("requestBody") @Valid YourJsonRequestBody jsonBody) {
        
        // 手动触发验证
        Set<ConstraintViolation<MultipartFile>> violations = validator.validate(file);
        if (!violations.isEmpty()) {
            // 抛出标准验证异常，与@Valid在POJO上的异常逻辑一致
            throw new MethodArgumentNotValidException(null, new org.springframework.validation.BindingResult() {
                @Override
                public boolean hasErrors() {
                    return true;
                }

                @Override
                public List<ObjectError> getAllErrors() {
                    return violations.stream()
                            .map(v -> new FieldError("custom_file", "custom_file", v.getMessage()))
                            .collect(Collectors.toList());
                }

                // 其他必要方法按需实现
            });
        }

        // 正常业务逻辑
        return file.getOriginalFilename();
    }
}

方案2：自定义参数解析器（自动验证，无需手动调用） #

实现HandlerMethodArgumentResolver，拦截带有@FileContentType注解的MultipartFile参数，自动完成验证。

1. 自定义参数解析器：

import org.springframework.core.MethodParameter;
import org.springframework.web.bind.support.WebDataBinderFactory;
import org.springframework.web.context.request.NativeWebRequest;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.ModelAndViewContainer;
import org.springframework.web.multipart.MultipartFile;
import jakarta.validation.ConstraintViolation;
import jakarta.validation.Validator;
import java.util.List;
import java.util.Set;
import java.util.stream.Collectors;

public class MultipartFileValidationResolver implements HandlerMethodArgumentResolver {

    private final Validator validator;

    public MultipartFileValidationResolver(Validator validator) {
        this.validator = validator;
    }

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        // 匹配带有@FileContentType注解的MultipartFile参数
        return parameter.getParameterType().equals(MultipartFile.class) &&
                parameter.hasParameterAnnotation(FileContentType.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        String paramName = parameter.getParameterName();
        MultipartFile file = webRequest.getPart(paramName);

        // 触发验证
        Set<ConstraintViolation<MultipartFile>> violations = validator.validate(file);
        if (!violations.isEmpty()) {
            // 抛出标准验证异常
            throw new MethodArgumentNotValidException(parameter, new org.springframework.validation.BindingResult() {
                @Override
                public boolean hasErrors() {
                    return true;
                }

                @Override
                public String getObjectName() {
                    return paramName;
                }

                @Override
                public List<ObjectError> getAllErrors() {
                    return violations.stream()
                            .map(v -> new FieldError(paramName, paramName, v.getMessage()))
                            .collect(Collectors.toList());
                }

                // 其他必要方法按需实现
            });
        }

        return file;
    }
}

2. 注册参数解析器：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import jakarta.validation.Validator;
import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final Validator validator;

    public WebConfig(Validator validator) {
        this.validator = validator;
    }

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new MultipartFileValidationResolver(validator));
    }
}

完成后，接口方法无需修改，保留@RequestPart("custom_file") @Valid @FileContentType(...) MultipartFile file即可自动触发验证。

方案3：使用@ControllerAdvice全局处理（备选） #

若不想手动验证或写解析器，可在@ControllerAdvice中监听文件上传请求，提前校验文件类型。此方式需手动匹配请求参数名，灵活性稍差：

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.multipart.MultipartFile;

@ControllerAdvice
public class FileValidationAdvice {

    @ModelAttribute("custom_file")
    public MultipartFile validateFile(MultipartFile file) {
        if (file != null && !MediaType.APPLICATION_PDF_VALUE.equals(file.getContentType())) {
            throw new IllegalArgumentException("仅支持PDF文件");
        }
        return file;
    }
}

此方案适合固定参数名的场景，若有多个不同参数名的文件需验证，需编写多个@ModelAttribute方法。

总结 #

• 方案1最快速，适合单个接口的临时需求；
• 方案2最优雅，适合多接口共用相同验证逻辑的场景，完全贴合Spring验证机制；
• 方案3最简单，但灵活性不足。

以上方案均适配你需要同时处理JSON请求体和MultipartFile的混合内容场景，无需将所有参数封装到同一POJO中。

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