Spring Boot用Thymeleaf发邮件：StandardTemplateModeHandlers导入失败

嘿，这个问题我之前踩过坑！核心原因是你用的Thymeleaf 3.x版本已经彻底移除了StandardTemplateModeHandlers这个类，这个API在Thymeleaf 2.x里存在，但3.x重构了模板模式的实现方式，所以IDE会报导入无法解析的错误。下面是具体的解决步骤：

1. 修正Maven依赖（推荐用Spring Boot Starter） #

Spring Boot项目不建议直接引入Thymeleaf核心包，改用spring-boot-starter-thymeleaf能自动管理版本和依赖，避免版本冲突。把你的依赖替换成下面的配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
    <groupId>nz.net.ultraq.thymeleaf</groupId>
    <artifactId>thymeleaf-layout-dialect</artifactId>
</dependency>

注：spring-boot-starter-thymeleaf已经包含了Thymeleaf核心、Spring整合模块等必要组件，不用手动指定版本号，Spring Boot会匹配最合适的版本。

2. 修改ThymeleafConfig.java代码 #

Thymeleaf 3.x用TemplateMode枚举替代了旧的StandardTemplateModeHandlers，你需要替换导入和模板模式的设置代码：

修正后的完整代码： #

import java.nio.charset.StandardCharsets;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
// 替换成这个新的导入
import org.thymeleaf.templatemode.TemplateMode;
import org.thymeleaf.templateresolver.ClassLoaderTemplateResolver;

@Configuration
public class ThymeleafConfig {
    @Bean
    public ClassLoaderTemplateResolver htmlTemplateResolver(){
        ClassLoaderTemplateResolver emailTemplateResolver = new ClassLoaderTemplateResolver();
        emailTemplateResolver.setPrefix("/templates/");
        emailTemplateResolver.setSuffix(".html");
        // 用TemplateMode.HTML替代旧的API
        emailTemplateResolver.setTemplateMode(TemplateMode.HTML.name());
        emailTemplateResolver.setCharacterEncoding(StandardCharsets.UTF_8.name());
        // 可选：设置优先级，让邮件模板解析器优先被使用
        emailTemplateResolver.setOrder(1);
        return emailTemplateResolver;
    }
}

3. 最后一步：刷新依赖并编译 #

在STS里右键你的项目 → 选择Maven → Update Project，等待依赖刷新完成后重新编译项目，导入错误就会消失了。

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