Spring中Hibernate Validator的@UUID注解启动时无法验证配置属性

一、@UUID注解不生效的原因及修复步骤 #

1. 确认Hibernate Validator版本
   @org.hibernate.validator.constraints.UUID是Hibernate Validator 6.1.0.Final及以后版本新增的注解，若项目依赖版本低于该版本，注解会无法生效。

• 若使用Spring Boot，Spring Boot 2.3.x及以上版本默认集成的Hibernate Validator版本满足要求；若为旧版本，需手动升级依赖。

2. 确保配置类开启验证触发
   配置属性类必须添加Spring的@Validated注解，否则Spring不会触发配置属性的验证逻辑。示例：

@ConfigurationProperties(prefix = "your.config")
@Validated
public class YourConfigProperties {
    @UUID
    private String id;
    // getter/setter
}

3. 检查自动配置是否被禁用
   确认项目中没有通过@SpringBootApplication(exclude = ValidationAutoConfiguration.class)或其他方式禁用Spring的验证自动配置，否则内置的验证器无法被加载。

4. 验证注解包导入正确
   确保导入的是org.hibernate.validator.constraints.UUID，而非其他同名注解。

二、快速查找注解对应的实现类 #

1. 查看注解的@Constraint元注解
   所有验证注解都会标注@Constraint注解，其中的validatedBy属性直接指定了该注解对应的验证器实现类。比如@UUID的定义：

@Constraint(validatedBy = UUIDValidator.class)
// 其他元注解
public @interface UUID {
    // ...
}

直接查看validatedBy的值就能找到实现类。

2. IDE快捷操作
   在IDEA等IDE中，右键点击注解名称，选择「Go to -> Declaration」进入注解定义，再点击validatedBy中的类名即可跳转至实现类；也可使用「Find Usages」功能查找该注解的验证器实现。

3. 内置约束验证器的位置
   Hibernate Validator的内置约束验证器统一放在org.hibernate.validator.internal.constraintvalidators包下，比如UUIDValidator就位于该包内。

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