SpringBoot中自定义请求参数验证器无法生效问题排查

看起来你的自定义验证器没被触发，大概率是Spring 4中方法级验证的配置没到位，我帮你梳理几个关键的遗漏步骤和问题点：

1. 必须配置MethodValidationPostProcessor启用方法级验证 #

在Spring 4中，要让控制器方法参数上的@ValidExtension这类自定义验证注解生效，必须显式配置MethodValidationPostProcessor来激活方法级别的Bean Validation支持。

Java配置方式： #

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.beanvalidation.MethodValidationPostProcessor;

@Configuration
public class ValidationConfig {
    @Bean
    public MethodValidationPostProcessor methodValidationPostProcessor() {
        return new MethodValidationPostProcessor();
    }
}

XML配置方式： #

<bean class="org.springframework.validation.beanvalidation.MethodValidationPostProcessor"/>

这个Bean是Spring识别并执行方法参数验证注解的核心配置。

2. 补充完整的Bean Validation依赖 #

你只添加了commons-validator，但Spring 4依赖Hibernate Validator作为JSR-380（Bean Validation）的标准实现，需要补充以下依赖：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.4.3.Final</version> <!-- 该版本适配Spring 4 -->
</dependency>
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.1.0.Final</version>
</dependency>

commons-validator是Apache的独立验证工具，和JSR-380的验证体系不兼容，必须添加标准的Bean Validation API及实现。

3. 修正验证器中的扩展名获取逻辑（非执行问题，但逻辑错误） #

你的FileExtensionValidator里用了file.getName()，这个方法返回的是请求参数的名称（即@RequestParam("file")中的"file"），不是上传文件的真实文件名！应该改成file.getOriginalFilename()：

@Override
public boolean isValid(MultipartFile file, ConstraintValidatorContext context) {
    if (file == null || file.isEmpty()) {
        // 可根据需求处理空文件场景，比如返回false或自定义提示
        return false;
    }
    String originalFilename = file.getOriginalFilename();
    if (originalFilename == null) {
        return false;
    }
    String extension = originalFilename.toLowerCase();
    return extension.endsWith(".png") || extension.endsWith(".jpeg");
}

同时把注解里的错误提示修正为文件相关内容：

String message() default "Invalid file extension. Only PNG and JPEG files are allowed.";

4. 确保组件被Spring正确扫描 #

确认你的控制器类标注了@Controller或@RestController，且Spring的组件扫描范围包含了控制器、FileExtensionValidator、ValidExtension所在的包。

完成以上配置后，你的验证逻辑应该就能正常执行了。

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