Spring Boot中@RequestPart参数校验失效问题及解决咨询

原因分析 #

Spring中@RequestPart和@RequestBody的参数解析逻辑存在差异：

• @RequestBody的解析器默认会自动触发Bean Validation，因为它直接绑定HTTP请求体，Spring原生就开启了对它的校验支持。
• @RequestPart主要用于处理multipart/form-data请求中的文件或复杂对象，其默认解析器不会自动触发校验逻辑——哪怕你给参数加了@Valid注解也没用，这就是问题的核心所在。

解决方法 #

方法一：用@Validated替代@Valid #

Spring提供的@Validated是@Valid的增强版，能更好适配@RequestPart这类参数的校验场景，直接替换注解即可生效：

@PostMapping(value = "/products", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<String> createProduct(
    @Validated @RequestPart("product") CreateProductRequestDto requestDto
) {
    // 业务逻辑代码
    return ResponseEntity.ok("产品创建成功");
}

方法二：确认DTO校验注解的正确性 #

检查你的DTO类中使用的校验注解是否来自正确的包：

• Spring Boot 2.x版本使用javax.validation.constraints包下的注解（如@NotBlank、@NotNull）
• Spring Boot 3.x版本使用jakarta.validation.constraints包下的注解
  示例DTO代码：

// Spring Boot 3.x示例
import jakarta.validation.constraints.NotBlank;

public class CreateProductRequestDto {
    @NotBlank(message = "test字段不能为空")
    private String test;

    // getter、setter方法
}

方法三：全局配置校验触发（可选） #

如果前两种方法不生效，可以通过自定义RequestPartMethodArgumentResolver强制开启校验，但这种方式较为繁琐，一般前两种方法就能解决问题，不推荐优先使用。

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