首页 > 解决方案 > spring boot 无法解析 thymeleaf 模板

问题描述

我是 Spring 5 和 Spring Boot 的新手。我正在尝试使用 thymeleaf 创建一个 spring 5/spring boot 应用程序。我想制造一场战争,而不是使用带有 Spring Boot 的嵌入式 Web 服务器。

当我部署我的战争时,我的应用程序启动并且我可以访问 src/main/resources/static/ 中的测试 html 页面,其中包含调用我的控制器的 javascript。我可以在这些页面上执行到我的控制器和数据库的往返。

但是,当我尝试打开位于 src/main/resources/templates/testtemplate.html 的 thymeleaf 页面时,我得到了 404

相关行家:

   <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.thymeleaf/thymeleaf-spring5 -->
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf</artifactId>
            <version>3.0.11.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf-spring5</artifactId>
            <version>3.0.11.RELEASE</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-thymeleaf -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
            <version>2.3.5.RELEASE</version>
        </dependency>

应用:

@SpringBootApplication(exclude = {HibernateJpaAutoConfiguration.class, DataSourceAutoConfiguration.class})
public class WarApplication extends SpringBootServletInitializer
    {

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application)
        {
        return application.sources(WarApplication.class);
        }

    public static void main(String[] args) throws Exception
        {
        SpringApplication.run(WarApplication.class, args);
        }

    @Override
    public void onStartup(ServletContext servletContext) throws ServletException
        {
        AnnotationConfigWebApplicationContext rootContext = new AnnotationConfigWebApplicationContext();
        rootContext.register(DataServiceConfig.class);

        servletContext.addListener(new ContextLoaderListener(rootContext));

        AnnotationConfigWebApplicationContext dispatcherContext = new AnnotationConfigWebApplicationContext();
        dispatcherContext.register(WebConfig.class);

        ServletRegistration.Dynamic dispatcher = servletContext.addServlet("dispatcher", new DispatcherServlet(dispatcherContext));
        dispatcher.setLoadOnStartup(1);
        dispatcher.addMapping("/");
        }
    }

网络配置:

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "com.myproject")
public class WebConfig implements WebMvcConfigurer
    {

    @Autowired
    ApplicationContext ctx;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry)
        {
        registry.addResourceHandler("/**").addResourceLocations("classpath:/static/");
        }

    @Bean
    @Description("Thymeleaf Template Resolver")
    public SpringResourceTemplateResolver  templateResolver()
        {
        SpringResourceTemplateResolver templateResolver = new SpringResourceTemplateResolver ();
        templateResolver.setPrefix("/templates/");
        templateResolver.setSuffix(".html");
        templateResolver.setTemplateMode(TemplateMode.HTML);
        return templateResolver;
        }


    @Bean
    @Description("Thymeleaf Template Engine")
    public SpringTemplateEngine templateEngine()
        {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.setTemplateResolver(templateResolver());
        templateEngine.setEnableSpringELCompiler(true);
        templateEngine.setTemplateEngineMessageSource(messageSource());
        return templateEngine;
        }
    
    @Bean
    @Description("Thymeleaf View Resolver")
    public ThymeleafViewResolver viewResolver()
        {
        ThymeleafViewResolver viewResolver = new ThymeleafViewResolver();
        viewResolver.setTemplateEngine(templateEngine());
        viewResolver.setOrder(1);
        return viewResolver;
        }


    @Bean
    @Description("Spring Message Resolver")
    public ResourceBundleMessageSource messageSource()
        {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        messageSource.setBasename("messages");
        return messageSource;
        }

在 Web 配置中,如果我删除 addResourceHandlers 方法,它不会改变任何内容。我仍然可以在 localhost:8080/ 找到我的静态页面。我尝试将这一行添加到它: registry.addResourceHandler("/**").addResourceLocations("classpath:/templates/");

当我这样做时,我可以在 localhost:8080/mytemplate.html 访问 thymeleaf 模板。但是,它显示为静态页面。片段不翻译。“th”标签似乎被忽略了。

我还尝试从我的 webconfig 中删除 templateResolver、viewResolver 和 templateEngine bean,因为我认为我可能正在覆盖一些自动配置。这没有任何效果。

我相信我的目录结构是相当标准的:

src/main/
       /java/com/myproject/[code here]
       /resources/static[web pages here]
       /resources/templates[thymeleaf pages here]

我错过了什么?
我是现代春天的新手。所以我可能会做一些愚蠢的事情。springboot 中的所有这些自动配置都非常令人沮丧,因为我不知道如何调试它在做什么。

标签: spring-bootthymeleafspring5

解决方案


以下是如何使用简单的 spring 为带有静态 js/css 资源的 thymeleaf html 提供服务@Controller

HTML - 带有百里香叶

主页.html

<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org">

<head>
    <meta charset="UTF-8">
    <title>Hello App</title>
    <!-- /resources/static/ folder is automatically mapped for static files -->
    <script th:src="@{/js/app.js}"></script>

</head>
<body>

<h2 th:text="${msg}"></h2>


</body>
</html>

应用程序.js:

alert("Hello Alert!")

带控制器的 Java

package demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

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

@Controller
class CtrlA {

    @GetMapping({"", "/"})
    String home(Model m) {
        m.addAttribute("msg", "Hello World");
        return "homePage";
    }
}

目录结构:

├── pom.xml
├── src
│   └── main
│       ├── java
│       │   └── demo
│       │       ├── DemoApplication.java
│       │       └── WebApp.java
│       └── resources
│           ├── application.properties
│           ├── static
│           │   └── js
│           │       └── app.js
│           └── templates
│               └── homePage.html

pom.xml:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.5.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>gt</groupId>
    <artifactId>web</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <java.version>11</java.version>
    </properties>

    <dependencies>

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

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

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>


推荐阅读