Spring Boot中实现LocalDateTime转String的ConversionService以解决Thymeleaf邮件模板类型转换失败问题

我完全理解你遇到的这个问题有多头疼——在使用Thymeleaf做邮件模板引擎时，模板里的LocalDateTime对象没法自动转成String，抛出了ConverterNotFoundException，你尝试了自定义Converter但没解决。我来帮你梳理两种可行的解决思路，从简单的官方工具到自定义转换器的正确配置：

方法一：使用Thymeleaf官方Java 8时间处理工具（最推荐） #

Thymeleaf有专门的扩展包来处理Java 8的时间API，不需要自己写转换器，直接在模板里格式化即可，这也是官方最推荐的方式：

步骤1：引入依赖 #

如果是Maven，在pom.xml中加入对应依赖（版本和你的Thymeleaf版本匹配即可）：

<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-java8time</artifactId>
    <version>3.1.2.RELEASE</version>
</dependency>

Gradle项目的话，在build.gradle中添加：

implementation 'org.thymeleaf.extras:thymeleaf-extras-java8time:3.1.2.RELEASE'

步骤2：在邮件模板中直接格式化LocalDateTime #

在Thymeleaf模板里，用#temporals工具类直接格式化时间对象，比如：

<!-- 自定义格式 -->
<p>邮件发送时间：[[${#temporals.format(localDateTimeObj, 'yyyy-MM-dd HH:mm:ss')}]]</p>

<!-- 使用默认格式 -->
<p>邮件发送时间：[[${#temporals.format(localDateTimeObj)}]]</p>

这种方式不需要任何后端配置，直接在模板层完成格式化，省心又不容易出错。

方法二：正确配置自定义Converter并关联到Thymeleaf的SpringTemplateEngine #

如果你更倾向于用自定义转换器的方式，那需要确保你的Converter被Thymeleaf的SpringTemplateEngine正确加载——你之前的配置问题主要出在Converter的注册逻辑和TemplateEngine的关联上，下面是正确的实现步骤：

步骤1：编写标准的LocalDateTime转String Converter #

import org.springframework.core.convert.converter.Converter;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class LocalDateTimeToStringConverter implements Converter<LocalDateTime, String> {
    // 定义固定的格式化规则
    private static final DateTimeFormatter DATE_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    @Override
    public String convert(LocalDateTime source) {
        return source.format(DATE_TIME_FORMATTER);
    }
}

步骤2：将Converter注册到Spring全局ConversionService #

在Spring Boot的配置类中，通过WebMvcConfigurer把Converter加入全局格式化器注册表，或者直接注册为Bean（Spring会自动把它加入全局ConversionService）：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    // 方式1：注册为Bean，Spring自动加入全局ConversionService
    @Bean
    public LocalDateTimeToStringConverter localDateTimeToStringConverter() {
        return new LocalDateTimeToStringConverter();
    }

    // 方式2：通过addFormatters手动注册，和方式1效果一致
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new LocalDateTimeToStringConverter());
    }
}

步骤3：让邮件用的SpringTemplateEngine使用全局ConversionService #

修改你的TemplateEngine配置，确保它关联Spring的全局ConversionService，而不是自己创建独立的服务：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.ConversionService;
import org.thymeleaf.spring6.SpringTemplateEngine;
import org.thymeleaf.spring6.dialect.SpringStandardDialect;
import org.thymeleaf.templateresolver.ITemplateResolver;

@Configuration
public class ThymeleafEmailConfig {

    @Bean
    public ITemplateResolver thymeleafEmailTemplateResolver() {
        ClassLoaderTemplateResolver templateResolver = new ClassLoaderTemplateResolver();
        templateResolver.setResolvablePatterns(Collections.singleton("html/*"));
        templateResolver.setSuffix(".html");
        templateResolver.setTemplateMode("HTML");
        templateResolver.setCharacterEncoding("UTF-8");
        templateResolver.setCacheable(false);
        return templateResolver;
    }

    @Bean
    public SpringTemplateEngine emailTemplateEngine(ITemplateResolver thymeleafEmailTemplateResolver,
                                                   ConversionService conversionService) {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(thymeleafEmailTemplateResolver);
        
        // 给默认的SpringStandardDialect设置全局ConversionService
        SpringStandardDialect standardDialect = new SpringStandardDialect();
        standardDialect.setConversionService(conversionService);
        templateEngine.addDialect(standardDialect);
        
        return templateEngine;
    }
}

这样配置后，邮件模板里直接使用[[${localDateTimeObj}]]就能自动转成你定义的格式化字符串了。

为什么你之前的配置没生效？ #

你之前的尝试存在两个关键问题：

1. 单独注册了LocalDateTimeConverter为Bean，但没有把它加入到Spring的全局ConversionService中，导致Thymeleaf的模板引擎无法感知到这个转换器；
2. 你自己实现了IStandardConversionService，但内部的转换逻辑调用错误，而且这种方式绕开了Spring的全局ConversionService，容易和其他配置冲突。

现在用上面两种方法中的任意一种，都能顺利解决你的类型转换问题。

内容来源于stack exchange