Spring Boot整合Thymeleaf国际化配置启动报错求助

错误核心原因 #

报错栈的关键信息是java.lang.ClassNotFoundException: org.hibernate.validator.spi.resourceloading.ResourceBundleLocator，说明项目缺少Hibernate Validator依赖。LocalValidatorFactoryBean是Spring提供的Bean Validation整合类，它底层依赖Hibernate Validator作为JSR-380规范的实现，缺失该依赖会导致无法加载必要的类，进而触发Bean初始化失败。

解决方案 #

1. 添加Hibernate Validator依赖 #

根据项目使用的构建工具，添加对应依赖：

Maven（pom.xml）

如果使用Spring Boot父工程，无需指定版本，Spring Boot会自动管理兼容版本：

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

若未使用父工程，需指定与Spring Boot兼容的版本：

<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>7.0.4.Final</version> <!-- Spring Boot 3.x适配；Spring Boot 2.x用6.x版本 -->
</dependency>

Gradle（build.gradle）

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

2. 可选：临时移除非必要配置 #

如果当前项目不需要Bean Validation的国际化消息支持，可以先移除getValidator()方法的Bean定义，优先保证国际化核心功能（LocaleResolver、LocaleChangeInterceptor）正常运行，后续需要验证消息国际化时再恢复配置并添加依赖。

修改后的MvcConfig：

@Configuration
public class MvcConfig implements WebMvcConfigurer {

    private final MessageSource messageSource;

    public MvcConfig(MessageSource messageSource) {
        this.messageSource = messageSource;
    }

    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver slr = new SessionLocaleResolver();
        slr.setDefaultLocale(Locale.ENGLISH);
        return slr;
    }

    @Bean
    public LocaleChangeInterceptor localeChangeInterceptor() {
        LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
        lci.setParamName("lang");
        return lci;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(localeChangeInterceptor());
    }

    // 暂时移除验证器配置，后续需要时再恢复
}

3. 版本兼容性校验 #

确保Hibernate Validator版本与Spring Boot版本匹配：

• Spring Boot 2.x 对应 Hibernate Validator 6.x系列
• Spring Boot 3.x 对应 Hibernate Validator 7.x及以上系列
  使用Spring Boot父工程时，依赖管理会自动处理版本兼容，无需手动指定。

验证操作 #

1. 添加依赖后，执行构建命令刷新依赖（Maven：mvn clean install；Gradle：gradle clean build）
2. 重启项目，检查是否仍存在类加载异常
3. 测试国际化功能：访问页面时携带lang参数（如?lang=zh_CN），验证页面消息是否切换语言

内容的提问来源于stack exchange，提问作者Nunyet Calçada