Hibernate Validator：ElementType.TYPE_USE约束未生效问题排查

当你将@AirportId的@Target设置为ElementType.TYPE_USE并标注在字段上时，Bean Validation（JSR-380）不会触发对应的验证器，核心原因在于注解的语义和默认校验逻辑的扫描范围不匹配：

1. 注解作用位置的语义差异

   • 当@Target为FIELD时，注解直接绑定到字段本身，属于字段级约束，Bean Validation的默认校验流程会自动扫描并执行这类约束的验证器。
   • 当@Target为TYPE_USE时，标注在字段上的注解实际附着在字段的类型声明处（也就是示例中String类型的使用位置），而非字段本身。此时它属于「类型使用约束」，而非字段约束。

2. 默认校验逻辑的扫描范围限制
   Bean Validation的validator.validate()方法默认仅处理以下类型的约束：

   • 字段上的FIELD类型注解
   • 属性getter方法上的METHOD类型注解
   • 类级别的TYPE类型注解
     「类型使用约束」（TYPE_USE）不在默认扫描范围内，因此不会触发验证器执行。

如果需要保留TYPE_USE的兼容性，同时让字段上的注解生效，可以给注解同时指定多个Target类型：

@Target({ElementType.TYPE_USE, ElementType.FIELD})

这样注解既可以在类型使用场景（比如泛型参数、方法参数类型声明）生效，也能作为字段约束被默认校验逻辑识别执行。

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