Hibernate Validator约束注解不可见问题求助

哦这个坑我踩过！把带Hibernate Validator注解的Java Bean打包成Jar给Web项目当依赖，结果Validator不认@NotEmpty/@NotBlank，连反射都找不到这些注解——十有八九是打包或者依赖配置出问题了，给你几个靠谱的排查方向：

1. 先查Jar包有没有把注解装进去 #

别不信，我上次就是用maven-shade-plugin打包的时候不小心把注解类给过滤掉了！你可以直接把Jar包解压开，看看里面有没有org/hibernate/validator/constraints/NotBlank.class、javax/validation/constraints/NotEmpty.class这些文件。

• 要是用Maven打包，检查pom.xml里的打包插件（比如maven-jar-plugin或者shade插件）有没有加<excludes>把注解所在的包给排除了；
• Gradle的话就看jar任务里的exclude规则，别把javax.validation.constraints或者org.hibernate.validator.constraints给踢出去。

2. 检查依赖范围和版本一致性 #

有时候不是Jar没打包好，是Web项目和Bean Jar的Validator依赖没对齐：

• 如果你的Bean Jar里把Hibernate Validator设成了<scope>provided</scope>，那Web项目必须自己显式引入同版本的hibernate-validator依赖，不然Web项目里根本找不到注解类；
• 反过来，如果Web项目里的Validator依赖是provided，但你的Web容器（比如Tomcat）没自带Validator，也会出问题；
• 最稳妥的方式是：Bean Jar里把Validator设为compile，或者在Web项目的pom.xml里明确声明org.hibernate.validator:hibernate-validator的版本，确保和Bean Jar用的是同一个版本。

3. 确认Validator的初始化逻辑没问题 #

如果是Spring Web项目，要确保你用对了校验注解：

• 控制器方法里要用@Valid或者@Validated来触发校验，别漏了；
• 要是手动初始化Validator，别用那种简陋的Validation.buildDefaultValidatorFactory()，要确保工厂能扫描到依赖Jar里的Bean——比如Spring项目里可以用LocalValidatorFactoryBean，它会自动扫描所有classpath下的实体和注解；
• 可以写个测试代码，直接反射获取Bean上的注解，看看能不能拿到：

YourBean.class.getDeclaredField("yourField").getAnnotation(NotBlank.class);

如果返回null，那就是类加载或者打包的问题。

4. 排查类加载器冲突 #

这是比较隐蔽的问题，我之前遇到过Tomcat的WebAppClassLoader和系统类加载器加载了不同版本的Validator，导致注解类不兼容：

• 你可以在Web项目里加一段代码打印类加载器：

System.out.println(NotBlank.class.getClassLoader());
System.out.println(Validation.buildDefaultValidatorFactory().getClassLoader());

如果这两个类加载器不一样，那就是类加载冲突了；

• 解决办法是统一所有依赖的Validator版本，或者把Validator的Jar包放到Web项目的WEB-INF/lib下，确保WebAppClassLoader能加载到正确的版本。

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