Spring Boot中Thymeleaf能否同时支持MVC与WebFlux双模板引擎？

核心结论 #

官方原生没有设计支持同时配置两套Thymeleaf模板引擎分别适配Spring MVC与WebFlux场景。

原因说明 #

Spring Boot的自动配置逻辑中，ThymeleafAutoConfiguration会优先判定当前应用的Web类型：

• 若识别为Servlet类型（引入spring-boot-starter-web默认属于该类型），仅会初始化适配Spring MVC的视图解析器、模板引擎实例
• 若识别为Reactive类型（引入spring-boot-starter-webflux且未引入Servlet依赖时属于该类型），仅会初始化适配WebFlux的响应式视图解析器、模板引擎实例
  两类配置是互斥关系，自动装配阶段不会同时加载。

手动实现方案（非官方推荐） #

如果确实需要在同一个应用中同时支持两套场景，可以按照以下步骤手动配置：

• 排除Thymeleaf自动配置：在启动类的@SpringBootApplication注解中添加exclude = {ThymeleafAutoConfiguration.class, ThymeleafWebFluxAutoConfiguration.class}，避免自动加载互斥配置
• 手动定义Spring MVC适配的Thymeleaf相关Bean：分别声明ServletContextTemplateResolver、SpringTemplateEngine、ThymeleafViewResolver，指定专属的模板文件前缀（比如classpath:/templates/mvc/）、后缀等参数
• 手动定义WebFlux适配的Thymeleaf相关Bean：分别声明SpringWebFluxTemplateEngine、ThymeleafReactiveViewResolver，指定专属的模板文件前缀（比如classpath:/templates/webflux/），避免和MVC模板冲突

注意事项 #

该用法属于非主流场景，官方不会针对该场景做兼容性保障，后续Spring Boot版本升级可能出现适配问题，生产环境建议优先考虑拆分应用、或统一使用单套Web框架，稳定性更高。

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