SpringBoot整合thymeleaf 报错的解决方案

下面是详细讲解“SpringBoot整合thymeleaf报错的解决方案”的完整攻略。

问题描述

在SpringBoot项目中，使用Thymeleaf模板引擎进行页面渲染时，可能会出现如下错误提示：

Error resolving template [xxx], template might not exist or might not be accessible by any of the configured Template Resolvers

该错误一般是由于Thymeleaf模板的路径配置不正确或是Thymeleaf模板引擎无法找到指定的模板文件所致。接下来，我们将分别针对这两种情况进行详细说明。

解决方案

方案一：检查模板路径配置是否正确

在SpringBoot中，Thymeleaf模板文件默认存放在classpath:/templates/目录下。因此，在访问指定页面时，需要保证模板文件存在于该目录下。

同时，需要确保在application.properties/application.yml中配置了正确的模板路径，如下所示：

spring.thymeleaf.prefix=classpath:/templates/

如果模板路径配置不正确，则可能会出现上述错误提示。此时，我们需要检查模板路径配置是否正确，确保配置正确即可解决该问题。

示例说明：

假设我们有一个index.html文件，放在了src/main/resources/templates/目录下。

那么我们在Controller中就需要这样访问：

@RequestMapping("/index")
public String index(Model model){
    return "index";
}

方案二：修改Thymeleaf模板引擎的Template Resolver

如果模板路径配置正常，但依然无法解决问题，那么就需要查看一下Thymeleaf模板引擎的Template Resolver是否配置正确。在SpringBoot中，我们可以通过配置ThymeleafViewResolver来设置Thymeleaf模板引擎的Template Resolver。

示例代码如下：

@Configuration
public class ThymeleafConfiguration {

    @Autowired
    private ApplicationContext applicationContext;

    @Bean
    public SpringResourceTemplateResolver templateResolver(){
        SpringResourceTemplateResolver templateResolver=new SpringResourceTemplateResolver();
       //设置模板路径
        templateResolver.setPrefix("classpath:/templates/");
        templateResolver.setSuffix(".html");
        templateResolver.setTemplateMode(TemplateMode.HTML);
        templateResolver.setCacheable(false);
        return templateResolver;
    }

    @Bean
    public SpringTemplateEngine templateEngine(){
        SpringTemplateEngine templateEngine=new SpringTemplateEngine();
        templateEngine.setTemplateResolver(templateResolver());
        return templateEngine;
    }

    @Bean
    public ThymeleafViewResolver viewResolver(){
        ThymeleafViewResolver viewResolver=new ThymeleafViewResolver();
        viewResolver.setTemplateEngine(templateEngine());
        viewResolver.setCharacterEncoding("UTF-8");
        return viewResolver;
    }
}

在上述代码中，我们通过templateResolver()方法设置了模板路径为classpath:/templates/，并将其设置为SpringResourceTemplateResolver类型的实例，通过templateEngine()方法将其注入到了SpringTemplateEngine中，再通过viewResolver()方法将其注入到了ThymeleafViewResolver中。这样，我们就构建了一个完整的Thymeleaf模板引擎。

如果我们将模板文件放到了其他路径下，则需要修改templateResolver()方法中的prefix属性。

方案三：检查依赖是否正确

在pom.xml文件中，确保Thymeleaf的依赖包已经正确引入，如下所示：

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

如果依赖没有正确引入，则可能会导致模板引擎无法正常工作，出现上述错误提示。因此，我们需要检查依赖是否正确，确保依赖正确即可解决该问题。

总结

通过上述三种解决方案，我们可以轻松地解决Thymeleaf模板引擎报错的问题。在使用Thymeleaf模板引擎时，建议检查模板路径配置、Template Resolver是否正确，确保依赖包正确引入。这样，就可以避免出现上述错误提示，确保项目能够正常工作。