Thymeleaf中layout:decorate失效问题排查求助

我来帮你排查这个问题——你已经完成了基础的依赖配置、Bean注册和页面编写，但layout:decorate没生效，大概率是以下几个关键点没注意到：

1. 确认thymeleaf-layout-dialect版本兼容性 #

Spring Boot 1.5.x搭配的是Thymeleaf 2.1.x版本，而thymeleaf-layout-dialect 3.x系列只适配Thymeleaf 3.x和Spring Boot 2.x，如果不指定版本，Maven可能会自动拉取最新的3.x版本，导致方言不兼容。

你需要在pom.xml里明确指定兼容的2.x版本：

<dependency>
  <groupId>nz.net.ultraq.thymeleaf</groupId>
  <artifactId>thymeleaf-layout-dialect</artifactId>
  <version>2.2.2</version> <!-- 这个版本完美适配Spring Boot 1.5.x -->
</dependency>

2. 检查模板文件的存放路径 #

Thymeleaf默认只会扫描src/main/resources/templates目录下的模板文件，请确保layout.html和login.html都放在这个目录里。如果布局文件放在子目录（比如templates/layouts），那login.html里的layout:decorate要改成~{layouts/layout}。

3. 确保MvcConfig被Spring正确扫描 #

检查你的MvcConfig配置类所在的包是否被@SpringBootApplication的组件扫描覆盖：

• 如果启动类在com.example，而MvcConfig在com.example.config，那没问题；
• 如果启动类和配置类不在同一个包或子包下，需要在启动类上添加@ComponentScan(basePackages = "com.example.config")，或者把配置类移到启动类的子包中。

4. 验证Thymeleaf基础配置 #

在application.properties里添加或确认以下配置，保证Thymeleaf能正确解析模板：

spring.thymeleaf.mode=HTML5
spring.thymeleaf.cache=false <!-- 开发环境关闭缓存，避免修改后看不到效果 -->
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

尤其是prefix和suffix，如果配置错误，Thymeleaf找不到模板文件，布局自然无法生效。

5. 检查页面的layout声明细节 #

确认login.html中的layout:decorate属性路径正确：layout:decorate="~{layout}"这里的layout对应layout.html的文件名（不带后缀）。另外，页面中的layout:fragment名称要和布局文件中的片段完全匹配（比如你用的content片段是正确的）。

建议你先从版本兼容性开始排查，这是Spring Boot 1.5.x中遇到这个问题最常见的原因，然后依次检查其他点，应该就能解决问题了。

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