Spring Boot配置属性校验报错：找不到NotBlank约束验证器

以下是几种可能触发该异常的核心原因：

• Javax与Jakarta Validation API版本冲突
  Spring Boot 2.x系列依赖javax.validation包下的校验注解，而Spring Boot 3.x全面切换为jakarta.validation体系。如果你的类库基于Spring Boot 2.x使用javax.validation.constraints.NotBlank，但测试环境的主服务是Spring Boot 3.x（或反之），就会出现注解与验证器不匹配的情况——Hibernate Validator的实现只会对应一套API，跨体系的注解找不到对应的验证器实例。
  解决：统一类库和主服务的Spring Boot版本，或者调整类库的注解包，和主服务的Validation依赖体系保持一致。

• Validation依赖传递异常
  如果类库中spring-boot-starter-validation的依赖范围被设置为provided、test，或者类库的依赖管理规则导致主服务没有正确拉取到hibernate-validator实现包，就会出现只有Validation API、没有具体验证逻辑的情况，自然找不到对应String类型的校验器。
  解决：检查类库的依赖配置文件（pom.xml/build.gradle），确保spring-boot-starter-validation的依赖范围为默认的compile，同时通过依赖树确认主服务中存在有效版本的hibernate-validator。

• 主服务禁用了Validation自动配置
  若测试环境的主服务在@SpringBootApplication中添加了exclude = ValidationAutoConfiguration.class，会导致Spring Boot自动初始化验证器的逻辑被跳过，无法注册NotBlank对应的验证器实例。
  解决：检查主服务的启动类，移除该排除配置，或者手动配置LocalValidatorFactoryBean来初始化验证器。

• 配置类属性类型不匹配（罕见但需排查）
  即便其他服务正常，若类库中JwtTokenSettings的jwtSecret字段实际不是String类型（比如误定义为Object），会导致NotBlank注解绑定到错误类型上，触发UnexpectedTypeException。
  解决：检查类库中JwtTokenSettings的属性类型，确保jwtSecret为String，且NotBlank仅用于字符串类型字段。

内容的提问来源于stack exchange，提问作者Артём Власов