Exception processing template “ “: Error resolving template [], template might not exit

针对Thymeleaf模板解析失败的问题，请按照以下步骤检查和解决：

1. 确认配置文件正确性

• 属性前缀问题：确保在application.properties或application.yml中使用的是Spring Boot官方属性，而非自定义配置。正确的配置应为：

  properties

• spring.thymeleaf.prefix=classpath:/templates/ spring.thymeleaf.suffix=.html

  若使用YAML格式：

  yaml

  spring:
    thymeleaf:
      prefix: classpath:/templates/
      suffix: .html

  注意：配置项应为spring.thymeleaf而非thymeleaf，否则配置不生效。

2. 检查模板文件路径和命名

• 路径验证：模板文件必须位于项目的src/main/resources/templates目录下，且文件名与控制器返回的视图名称完全一致（包括大小写）。

• 文件名匹配：确保模板文件名为addUser.html（而非AddUser.html或adduser.html）。

3. 验证控制器代码

• 返回视图名称：控制器方法应直接返回视图名称（不带后缀），例如：

  java

  复制

  @GetMapping("/addUser")
  public String showAddUserForm() {
      return "addUser"; // 对应 templates/addUser.html
  }

• 避免注解干扰：确保方法没有使用@ResponseBody或@RestController，否则会直接返回字符串内容而非模板名称。

4. 检查依赖和构建结果

• 依赖检查：在pom.xml或build.gradle中确认已引入Thymeleaf依赖：

  xml

  复制

  <!-- Maven -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>
  </dependency>

  运行 HTML

• 构建验证：清理并重新构建项目，检查target/classes/templates或生成的JAR/WAR文件中是否包含addUser.html。（这里是我出现的问题）

5. 关闭Thymeleaf缓存（开发环境）

• 在application.properties中添加：

  properties

  复制

  spring.thymeleaf.cache=false

• 重启应用，确保模板修改实时生效。

6. 排查操作系统路径大小写敏感问题

• 如果开发环境是Windows（路径不区分大小写）而部署环境是Linux（区分大小写），确保文件名和路径中的大小写完全一致。

7. 检查模板内容语法

• 即使模板文件存在，若内部存在语法错误（如未闭合的HTML标签、错误的Thymeleaf表达式），也可能导致渲染失败。但此时错误日志会提示具体行号，而非“找不到模板”。