Spring Boot 3.2.0集成Thymeleaf Layout Dialect无需显式配置Bean？

我有一个Spring Boot Maven项目，父依赖配置如下：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

引入的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<dependency>
    <groupId>nz.net.ultraq.thymeleaf</groupId>
    <artifactId>thymeleaf-layout-dialect</artifactId>
</dependency>

实际依赖版本：

• org.springframework.boot:spring-boot-starter-thymeleaf:jar:3.2.0
• nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect:jar:3.3.0

旧版Thymeleaf文档提到：

使用Layout Dialect需先在pom.xml中引入依赖：

<dependency>
  <groupId>nz.net.ultraq.thymeleaf</groupId>
  <artifactId>thymeleaf-layout-dialect</artifactId>
  <version>2.0.5</version>
</dependency>

还需配置模板引擎，添加额外方言：

@Bean
public SpringTemplateEngine templateEngine() {
    SpringTemplateEngine templateEngine = new SpringTemplateEngine();
    ...
    templateEngine.addDialect(new LayoutDialect());
    return templateEngine;
}

但我既没配置SpringTemplateEngine Bean，也没配置nz.net.ultraq.thymeleaf.layoutdialect.LayoutDialect Bean，项目却能正常运行。为了验证，我写了如下Controller：

@Controller
public class DemoController {

    @Autowired
    LayoutDialect layoutDialect;

    @GetMapping("/demo")
    public String getAllUsers() {
        System.out.println(layoutDialect);
        return "thymeleaf_first_page";
    }
}

控制台输出：

nz.net.ultraq.thymeleaf.layoutdialect.LayoutDialect@7c6ab057

这说明LayoutDialect Bean已经存在于Spring上下文里了。

核心问题 #

能否确认：使用新版Spring Boot（搭配spring-boot-starter-thymeleaf）时，无需显式添加LayoutDialect Bean？是否有相关文档依据？

补充说明（非核心） #

布局文件（src/main/resources/templates/layout/layout.html）：

<!DOCTYPE html>
<html lang="en" xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title layout:fragment="title"></title>
</head>
<body>
<header>
    <nav><span>LOGO</span> <a href="#">LINK1</a> <a href="#">LINK2</a> </nav>
</header>
    <main id="mainpart" layout:fragment="main">
        <p><em>This content must not be visible.</em></p>
    </main>
<footer>Footer information</footer>
</body>
</html>

页面文件（src/main/resources/templates/thymeleaf_first_page.html）：

<html xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
      xmlns:th="http://www.thymeleaf.org"
      layout:decorate="~{layout/layout}">
<head>
    <title layout:fragment="title">Thymeleaf demo</title>
</head>
<body>
    <main layout:fragment="main">
        <h1>Thymeleaf template extension demo</h1>
        <p>Actual page content: [<th:block th:text="${modelValue}" />]</p>
    </main>
</body>
</html>

最终渲染结果：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    
    <title>Thymeleaf demo</title>
    
</head>
<body>
<header>
    <nav><span>LOGO</span> <a href="#">LINK1</a> <a href="#">LINK2</a> </nav>
</header>
    <main id="mainpart">
        <h1>Thymeleaf template extension demo</h1>
        <p>Actual page content: [some value from the model]</p>
    </main>
<footer>Footer information</footer>
</body>
</html>

可以明确确认：使用新版Spring Boot（如你所用的3.2.0版本）搭配spring-boot-starter-thymeleaf，同时引入thymeleaf-layout-dialect依赖时，无需手动配置LayoutDialect Bean。

原因说明 #

Spring Boot的自动配置机制会自动检测classpath中的Thymeleaf方言类，并将其注册为Spring Bean，同时自动添加到SpringTemplateEngine中。

具体来说，Spring Boot的ThymeleafAutoConfiguration会借助ThymeleafDialectConfiguration扫描并注册所有实现了org.thymeleaf.dialect.IDialect接口的Bean，而LayoutDialect恰好实现了该接口。只要依赖正确引入，Spring Boot就会自动完成Bean的创建和模板引擎的配置。

文档依据 #

Spring Boot官方文档中关于Thymeleaf的部分提到，Spring Boot会自动配置Thymeleaf，并自动注册任何存在于classpath中的Thymeleaf方言。此外，thymeleaf-layout-dialect从3.x版本开始适配了Spring Boot的自动配置规则，无需手动注册Bean。

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