Spring Boot升级至2.5.4以上版本后Thymeleaf装饰器布局失效问题

这个渲染异常不是Spring Boot与Thymeleaf核心兼容规则变更导致的，是两个配置/API迭代的问题叠加：

• 你业务页面里用的layout:decorator是thymeleaf-layout-dialect 2.x版本的旧属性，3.0.0版本开始该属性就被标记废弃，到你引入的3.1.0版本，默认已经不再对这个旧属性执行装饰逻辑，只识别新的标准属性layout:decorate。
• Spring Boot 2.5.14~2.6.7区间版本默认内置的Thymeleaf版本为3.0.15+，和你手动指定的thymeleaf-layout-dialect 3.1.0搭配时，旧layout:decorator属性的兼容兜底逻辑默认关闭，直接导致整个布局装饰流程没有触发，布局模板里通过th:replace写的sidebar、footer等公共片段自然不会被渲染，只有业务页面里手动引入的片段能正常解析。

另外你贴的主布局模板末尾多了一个多余的</div>闭合标签，后续修复装饰逻辑后记得删掉，避免DOM结构错乱。

不需要在每个业务页手动引入公共片段，选下面任意一种方案就能恢复原有自动布局效果：

• 方案一（推荐，无长期兼容隐患）：全局替换所有业务页面的属性，把layout:decorator="layouts/base_layout"改成layout:decorate="layouts/base_layout"即可。这是thymeleaf-layout-dialect 3.x的官方标准写法，替换后装饰流程会正常执行，布局内的所有公共片段都会正常渲染。
• 方案二（不想批量改模板的临时兼容方案）：在项目配置中开启旧属性兼容开关。
  如果是properties格式配置，添加：

  spring.thymeleaf.layout-dialect.legacy-decorator=true
  

  如果是yml格式配置，添加：

  spring:
    thymeleaf:
      layout-dialect:
        legacy-decorator: true
  

  开启后3.1.0版本的布局方言会重新识别旧的layout:decorator属性，恢复原有装饰逻辑。

Spring Boot 2.5.14及之后的2.5.x版本、2.6.0~2.6.7版本，默认管理的thymeleaf-layout-dialect版本就是3.1.0，匹配的Thymeleaf版本为3.0.15.RELEASE，这组依赖是经过官方兼容验证的，不存在核心适配问题，异常的核心原因是旧API废弃后兼容逻辑的默认值调整，不是框架本身不兼容。

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