SpringMVC 配置錯誤：NoClassDefFoundError javax/validation/ValidatorFactory 完整解析

錯誤堆疊核心訊息

CannotLoadBeanClassException: Error loading class [org.springframework.validation.beanvalidation.LocalValidatorFactoryBean]
nested exception is java.lang.NoClassDefFoundError: javax/validation/ValidatorFactory

根本原因

專案缺少 Bean Validation API (JSR-303/349/380) 實作相依套件。Spring 嘗試實例化 LocalValidatorFactoryBean 時，類別路徑找不到 javax.validation.ValidatorFactory 介面。

解決方案 (Maven 專案)

方案一：補齊 API 與實作 (推薦 Hibernate Validator)

<dependency>
    <groupId>jakarta.validation</groupId>
    <artifactId>jakarta.validation-api</artifactId>
    <version>3.0.2</version>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>8.0.1.Final</version>
</dependency>
<!-- 若使用舊版 Spring (javax 命名空間) -->
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.2.5.Final</version>
</dependency>

方案二：排除衝突的傳遞性相依

若專案已引入 spring-boot-starter-validation，請檢查是否有其他套件排除或覆蓋了 validation-api，使用 mvn dependency:tree | grep validation 確認。

Spring XML 配置檢查

<mvc:annotation-driven validator="validator"/>
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean"/>

確保上述配置存在且 validator bean 名稱一致。

版本對照表