如何在Spring Boot中配置多个SpringResourceTemplateResolver实例？

问题原因分析 #

你的配置出现错误主要有三个核心原因：

1. @EnableWebMvc 覆盖自动配置：该注解会禁用Spring Boot自带的Thymeleaf自动配置逻辑，导致自定义的TemplateResolver无法被正确关联到视图解析流程中。
2. 模板路径前缀缺失标识：SpringResourceTemplateResolver需要明确资源位置前缀（如classpath:），直接写/templates/无法正确定位类路径下的模板文件。
3. 未统一注册解析器到模板引擎：多个TemplateResolver必须被添加到SpringTemplateEngine中，Thymeleaf才会按顺序遍历查找模板。

正确配置示例 #

下面是适配Spring Boot + Thymeleaf 3的非过时多模板路径配置：

@Configuration
public class MvcConfig implements WebMvcConfigurer {

    // 静态资源配置（保留原有逻辑即可）
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }

    // 第一个模板解析器：优先级更高
    @Bean
    public SpringResourceTemplateResolver templateResolver1() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setPrefix("classpath:/templates/"); // 明确类路径前缀
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCharacterEncoding("UTF-8");
        resolver.setOrder(0); // 数字越小优先级越高
        resolver.setCheckExistence(true); // 启用存在检查，找不到时自动尝试下一个解析器
        return resolver;
    }

    // 第二个模板解析器
    @Bean
    public SpringResourceTemplateResolver templateResolver2() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setPrefix("classpath:/templates-2/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCharacterEncoding("UTF-8");
        resolver.setOrder(1);
        resolver.setCheckExistence(true);
        return resolver;
    }

    // 统一配置模板引擎，注入所有解析器
    @Bean
    public SpringTemplateEngine templateEngine(List<ITemplateResolver> templateResolvers) {
        SpringTemplateEngine engine = new SpringTemplateEngine();
        engine.setTemplateResolvers(templateResolvers);
        return engine;
    }
}

关键配置说明 #

• 移除@EnableWebMvc：保留Spring Boot的Thymeleaf自动配置，自动完成视图解析器注册等基础工作，避免手动配置遗漏。
• classpath:前缀：确保SpringResourceTemplateResolver能正确扫描类路径下的模板目录，适配Spring Boot的资源加载规则。
• setOrder()：控制模板查找顺序，优先级高的解析器先尝试，找不到时自动切换到下一个（需配合setCheckExistence(true)）。
• 模板引擎统一管理解析器：通过List<ITemplateResolver>自动注入所有自定义解析器，无需手动逐个添加，保证扩展性。

特殊场景：必须使用@EnableWebMvc的情况 #

如果因业务需求必须保留@EnableWebMvc，需要手动注册Thymeleaf视图解析器：

@Bean
public ViewResolver thymeleafViewResolver(SpringTemplateEngine templateEngine) {
    ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
    viewResolver.setTemplateEngine(templateEngine);
    viewResolver.setCharacterEncoding("UTF-8");
    return viewResolver;
}

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