如何为单个Spring Boot实例配置多个Thymeleaf模板解析器？

看起来你遇到的核心问题是自定义配置覆盖了Spring Boot的自动配置，或者没有正确将多个解析器添加到同一个TemplateEngine中。我来帮你梳理下错误点和正确的实现方式：

你之前的错误分析 #

1. 使用@EnableWebMvc的问题：这个注解会完全接管Spring MVC的配置，禁用大部分自动配置（包括默认的Thymeleaf解析器）。你自定义的TemplateEngine如果没有被对应的ThymeleafViewResolver使用，就会导致默认的解析器依然生效，而你的自定义解析器被忽略。
2. YAML配置写成数组无效：Spring Boot的ThymeleafProperties并不支持数组形式的配置，所以你写的多组配置只会被解析成最后一组（或者第一组），无法生成多个解析器。
3. 自定义TemplateEngine只添加了一个解析器：你在配置类中只给TemplateEngine设置了一个指向/public/的解析器，自然看不到第二个解析器。

正确实现方式（两种可选） #

方案一：基于Spring Boot自动配置，添加额外解析器

这种方式保留Spring Boot默认的templates/解析器，只添加自定义的public/解析器，最简洁：

@Configuration
public class ThymeleafExtraConfig implements ApplicationContextAware {

    private ApplicationContext applicationContext;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    // 定义第二个模板解析器
    @Bean
    public ITemplateResolver publicTemplateResolver() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setApplicationContext(applicationContext);
        resolver.setPrefix("/public/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCacheable(false);
        resolver.setOrder(1); // 优先级高于默认解析器（默认order是10），先查找public目录
        return resolver;
    }

    // 将自定义解析器添加到自动配置的TemplateEngine中
    @Autowired
    public void configureTemplateEngine(SpringTemplateEngine templateEngine) {
        templateEngine.addTemplateResolver(publicTemplateResolver());
    }
}

你的YAML配置可以保留原来的基础配置：

thymeleaf:
  mode: LEGACYHTML5
  cache: false

方案二：完全自定义TemplateEngine（包含两个解析器）

如果你需要完全控制TemplateEngine的配置，可以手动定义两个解析器并添加到同一个引擎中：

@Configuration
public class ThymeleafConfig implements ApplicationContextAware {

    private ApplicationContext applicationContext;

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    // 默认的templates目录解析器
    @Bean
    public ITemplateResolver defaultTemplateResolver() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setApplicationContext(applicationContext);
        resolver.setPrefix("classpath:/templates/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCacheable(false);
        resolver.setOrder(2); // 优先级低于public解析器
        return resolver;
    }

    // 自定义的public目录解析器
    @Bean
    public ITemplateResolver publicTemplateResolver() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setApplicationContext(applicationContext);
        resolver.setPrefix("/public/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCacheable(false);
        resolver.setOrder(1);
        return resolver;
    }

    // 创建包含两个解析器的TemplateEngine
    @Bean
    public SpringTemplateEngine templateEngine() {
        SpringTemplateEngine engine = new SpringTemplateEngine();
        engine.addTemplateResolver(defaultTemplateResolver());
        engine.addTemplateResolver(publicTemplateResolver());
        // 可添加其他配置，比如方言、消息解析器等
        return engine;
    }

    // 配置ViewResolver使用自定义的TemplateEngine
    @Bean
    public ThymeleafViewResolver thymeleafViewResolver() {
        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
        resolver.setTemplateEngine(templateEngine());
        resolver.setCharacterEncoding("UTF-8");
        return resolver;
    }
}

额外优化：精准匹配模板路径 #

如果需要指定哪些模板使用哪个解析器，可以给解析器添加resolvablePatterns，比如：

// 只处理以public/开头的模板
resolver.setResolvablePatterns(Collections.singleton("public/*"));

这样只有当模板路径匹配public/*时，才会使用这个解析器，避免不必要的查找。

内容的提问来源于stack exchange，提问作者D-Dᴙum