Jakarta自定义约束验证器未触发问题排查

以下是几个可能导致你的自定义验证器未被调用的原因及解决办法：

1. 缺失必要的验证依赖（Spring Boot 2.3+） #

从Spring Boot 2.3版本开始，spring-boot-starter-validation不再默认包含在spring-boot-starter-web中，需要手动添加依赖：

Maven #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

Gradle #

implementation 'org.springframework.boot:spring-boot-starter-validation'

如果没有添加该依赖，Bean Validation相关组件无法初始化，自然不会触发验证逻辑。

2. 验证器未被Spring容器管理 #

确保MyValidator被Spring扫描并注册为Bean，可直接给类添加@Component注解：

@Component
public class MyValidator implements ConstraintValidator<ValidCustomClass, CreateRequest> {
    // 原有代码逻辑
}

或者确认com.validation包在Spring Boot的组件扫描范围内（即被@SpringBootApplication或@ComponentScan注解覆盖）。

3. 控制器参数验证的注解适配问题 #

虽然你在控制器类上加了@Validated，参数上加了@Valid，但可以尝试将参数上的@Valid替换为@Validated，确保触发类级别的验证：

public MyResponse create(@RequestBody @Validated CreateRequest request) throws Exception {
    return myService.create(request);
}

@Validated是Spring扩展的验证注解，相比标准的@Valid，更适配类级别自定义验证的触发场景。

4. 确认注解的标注位置 #

检查@ValidCustomClass是否标注在CreateRequest的类级别上，因为你的注解@Target指定了ElementType.TYPE，字段上的标注不会生效：

@ValidCustomClass
public class CreateRequest {
    // 类字段定义
}

5. 代码笔误修正（不影响调用但需注意） #

你的isValid方法中调用了dosSomething(value)，此处应为doSomething（少一个字母o），虽然这不会导致验证器不执行，但会引发编译错误，需修正该笔误。

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