Spring Boot集成Vault与Mongo启动失败：Bean Validation缺失实现

问题描述 #

我正在使用Spring Boot开发API，集成了Vault与Mongo，但应用启动失败。报错日志如下：

2022-09-07 13:58:56.510 WARN 23885 --- [ main] s.c.a.AnnotationConfigApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'org.springframework.cloud.vault.config.VaultReactiveBootstrapConfiguration': Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.boot.context.properties.ConfigurationPropertiesBindException: Error creating bean with name 'spring.cloud.vault-org.springframework.cloud.vault.config.VaultProperties': Could not bind properties to 'VaultProperties' : prefix=spring.cloud.vault, ignoreInvalidFields=false, ignoreUnknownFields=true; nested exception is javax.validation.NoProviderFoundException: Unable to create a Configuration, because no Jakarta Bean Validation provider could be found. Add a provider like Hibernate Validator (RI) to your classpath.
2022-09-07 13:58:56.513 INFO 23885 --- [ main] ConditionEvaluationReportLoggingListener :

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2022-09-07 13:58:56.521 ERROR 23885 --- [ main] o.s.b.d.LoggingFailureAnalysisReporter :

---

APPLICATION FAILED TO START

---

Description:

The Bean Validation API is on the classpath but no implementation could be found

Action:

Add an implementation, such as Hibernate Validator, to the classpath

补充疑问：根据报错信息nested exception is javax.validation.NoProviderFoundException: Unable to create a Configuration, because no Jakarta Bean Validation provider could be found.，怀疑Spring Boot同时使用了javax和Jakarta，这属于正常情况吗？

解决方案与疑问解答 #

1. 启动失败的直接修复 #

报错日志已明确给出修复方向：为项目添加Bean Validation的实现类依赖，推荐使用Hibernate Validator。

• Maven项目在pom.xml中添加：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
</dependency>

• Gradle项目在build.gradle中添加：

implementation 'org.hibernate.validator:hibernate-validator'

2. javax与Jakarta共存的合理性 #

这种情况不属于正常情况，本质是依赖版本冲突导致的：

• Spring Boot 2.x体系依赖javax.validation包下的Bean Validation API；
• Spring Boot 3.x体系完全迁移至Jakarta EE规范，使用jakarta.validation包；
• 报错中同时出现javax.validation相关异常和Jakarta provider缺失提示，说明项目混合引入了不同版本的Bean Validation依赖，部分依赖基于javax规范，部分基于Jakarta规范，导致API与实现不匹配。

3. 额外排查建议 #

• 生成项目依赖树，定位并排除冲突的javax/Jakarta版本的validation相关依赖；
• 确保Spring Boot、Spring Cloud Vault等组件版本匹配，避免跨大版本组合依赖；
• 若使用Spring Boot 3.x，需确保所有相关依赖都支持Jakarta规范，Hibernate Validator需使用7.x及以上版本。

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