Spring Boot整合Thymeleaf模板找不到及解析异常求助

针对你遇到的「无法找到模板位置classpath:/templates/」警告和TemplateInputException异常，以下是具体排查和解决步骤：

1. 修正自定义Thymeleaf解析器配置 #

默认情况下Spring Boot会自动加载Thymeleaf的默认配置，若你自定义了解析器，需确保配置完全覆盖默认逻辑，避免冲突：

完整的自定义配置类示例 #

@Configuration
public class ThymeleafCustomConfig {

    // 配置模板解析器，适配/WEB-INF/views/路径
    @Bean
    public TemplateResolver templateResolver() {
        ServletContextTemplateResolver resolver = new ServletContextTemplateResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".html");
        resolver.setTemplateMode(TemplateMode.HTML);
        resolver.setCharacterEncoding("UTF-8");
        resolver.setOrder(1); // 设置优先级，确保优先使用该解析器
        resolver.setCacheable(false); // 开发阶段关闭缓存，避免调试时缓存干扰
        return resolver;
    }

    // 配置模板引擎，绑定自定义解析器
    @Bean
    public SpringTemplateEngine templateEngine(TemplateResolver templateResolver) {
        SpringTemplateEngine engine = new SpringTemplateEngine();
        engine.setTemplateResolver(templateResolver);
        return engine;
    }

    // 配置视图解析器，绑定模板引擎
    @Bean
    public ViewResolver viewResolver(SpringTemplateEngine templateEngine) {
        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
        resolver.setTemplateEngine(templateEngine);
        resolver.setCharacterEncoding("UTF-8");
        return resolver;
    }
}

注意：若你的项目是Jar包结构，/WEB-INF/views/目录默认不会被识别，需改用ClassPathTemplateResolver，并将视图文件放在src/main/resources/WEB-INF/views/下，修改前缀为classpath:/WEB-INF/views/。

2. 排除默认Thymeleaf自动配置 #

为了彻底避免默认配置和自定义配置冲突，在Spring Boot启动类上排除自动配置类：

@SpringBootApplication(exclude = ThymeleafAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 确认项目结构正确性 #

• 若为War包结构：/WEB-INF/views/需放在src/main/webapp目录下（这是Java Web项目的标准Web资源目录）。
• 若为Jar包结构：将视图文件移至src/main/resources/WEB-INF/views/，并对应修改解析器的前缀为classpath:/WEB-INF/views/。

4. 检查Controller返回值 #

确保Controller返回的视图名称与模板文件路径一致，无需添加后缀（解析器已配置后缀）：

@Controller
@RequestMapping("/people")
public class PeopleController {

    @GetMapping("/info")
    public String getPeopleInfo(Model model) {
        // 业务逻辑处理
        return "people/info"; // 对应/WEB-INF/views/people/info.html
    }
}

5. 验证依赖配置 #

确保pom.xml中Thymeleaf依赖正确，避免版本冲突：

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

若为War包部署，需指定打包方式：

<packaging>war</packaging>

内容的提问来源于stack exchange，提问作者Денис Кузнецов