Spring Boot集成Thymeleaf布局时模板解析错误求助

针对你遇到的Error resolving template [accueil]错误，结合Spring Boot+Thymeleaf布局的常见坑，给你几个直接的排查方向：

1. 模板文件路径与命名必须严格匹配 #

• 先确认accueil.html的位置：默认要放在src/main/resources/templates/下，如果你在application.properties里配置了spring.thymeleaf.prefix，比如spring.thymeleaf.prefix=classpath:/templates/pages/，那文件必须放在src/main/resources/templates/pages/目录下
• 文件名区分大小写，控制器返回的"accueil"要和文件名完全一致，比如不能把文件命名为Accueil.html却返回小写的accueil
• 检查layout.html的引用：如果用layout:decorate，子页面里的路径要正确，比如layout在根目录就写layout:decorate="~{layout}"，在子目录就写~{layouts/layout}

2. 控制器与视图解析配置要对应 #

• 控制器返回值不要带后缀，比如返回"accueil"而不是"accueil.html"，Thymeleaf会自动拼接你配置的spring.thymeleaf.suffix
• 核对application.properties的配置，确保没有错误：

  spring.thymeleaf.prefix=classpath:/templates/
  spring.thymeleaf.suffix=.html
  spring.thymeleaf.enabled=true
  spring.thymeleaf.cache=false # 开发环境关缓存，避免修改不生效
  

  注意前缀必须加classpath:/，否则可能找不到资源

3. 依赖必须正确引入 #

• 确保pom.xml里有Thymeleaf starter和布局方言依赖，这是实现布局的核心：

  <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>
  

  不要手动指定版本，Spring Boot的starter会自动管理兼容版本

4. 排查模板语法与日志细节 #

• 打开accueil.html检查是否有语法错误，比如未闭合的标签、错误的Thymeleaf表达式，语法错误会导致模板无法被解析，进而被判定为不存在
• 查看启动日志，里面会有更详细的路径提示，比如“找不到classpath:/templates/accueil.html”，可以直接定位问题

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