我要评论前言
在当今快速发展的软件开发领域，构建高效、可维护且功能强大的 web 应用是每个开发团队的追求目标。spring boot 作为一款备受推崇的 java 基础框架，凭借其简洁的配置、强大的依赖管理和快速开发的特性，已经成为众多开发者的首选。与现在流行的vue和react不同，thymeleaf也是一种比较常见的模板引擎技术， thymeleaf，作为一种现代的、功能丰富的模板引擎，以其自然模板的特性、与 html 的无缝兼容以及对静态原型的支持，成为与 spring boot 搭配构建 web 应用的理想选择。
为了帮助广大开发者更好地掌握 spring boot 2.7.8 与 thymeleaf 的集成，本文将深入探讨这一主题。我们将从集成的基础开始，详细介绍如何在 spring boot 项目中引入 thymeleaf，并进行必要的配置以确保它们能够协同工作。我们会分享一些最佳实践，包括如何组织模板文件、如何利用 thymeleaf 的变量表达式和条件语句来构建动态页面，以及如何优化模板的加载和渲染性能。除了介绍集成的方法和技巧，本文还将重点关注开发过程中可能遇到的常见问题。我们会通过实际案例，分析这些问题产生的原因，并提供有效的解决方案。无论是处理模板路径的冲突、解决视图解析的错误，还是优化应用的启动时间，我们都会给出详细的步骤和代码示例，帮助读者快速定位并解决问题。当然现在thymeleaf并不是前后端分离架构的最优解，因此本文给一些想学习springboot的朋友提供示例说明和参考。
通过阅读本文，你将能够更加深入地理解 spring boot 2.7.8 和 thymeleaf 的集成机制，掌握最佳实践，避免常见的陷阱，并且能够快速应对开发过程中遇到的各种挑战。让我们一起踏上这段学习之旅，探索如何利用这两个强大的工具构建出卓越的 web 应用。
一、如何构建springboot应用
spring boot 2.7.8 版本的发布，为开发者带来了更加稳定和优化的开发环境。它在性能、安全性以及兼容性等方面都有显著的提升，使得基于该版本构建的应用能够更好地适应各种复杂的业务场景。在这样的背景下，将 thymeleaf 与 spring boot 2.7.8 进行集成，不仅可以充分发挥 spring boot 的优势，还能利用 thymeleaf 强大的模板渲染能力，打造出用户体验出色、开发效率高的 web 应用。本节将重点介绍如何快速构建springboot应用，包括pom.xml的定义、如何创建控制器类，如何创建thyemleaf模板文件和主应用程序启动类。
1、项目依赖 (pom.xml)
这里使用的jdk是1.8。因此这里使用springboot2.7.8作为开发框架。如果对最新的springboot有需要，也可以使用新版的springboot，集成过程大同小异。这里我们使用maven的方式进行依赖管理。在pom.xml中添加以下引用：
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelversion>4.0.0</modelversion> <groupid>org.yelang</groupid> <artifactid>baidu-sse-client</artifactid> <version>0.0.1-snapshot</version> <parent> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-parent</artifactid> <version>2.7.18</version> <!-- 兼容jdk 8的spring boot版本 --> <relativepath /> <!-- lookup parent from repository --> </parent> <properties> <java.version>1.8</java.version> <!-- 使用jdk 8 --> <project.build.sourceencoding>utf-8</project.build.sourceencoding> <project.reporting.outputencoding>utf-8</project.reporting.outputencoding> </properties> <dependencies> <!-- spring boot webflux (包含webclient) --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-webflux</artifactid> </dependency> <!-- spring boot web (可选，如果也需要传统web mvc) --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-web</artifactid> </dependency> <!-- jackson json处理 --> <dependency> <groupid>com.fasterxml.jackson.core</groupid> <artifactid>jackson-databind</artifactid> </dependency> <!-- 测试依赖 --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter-test</artifactid> <scope>test</scope> </dependency> <dependency> <groupid>io.projectreactor</groupid> <artifactid>reactor-test</artifactid> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-maven-plugin</artifactid> </plugin> <!-- 确保使用jdk 8编译 --> <plugin> <groupid>org.apache.maven.plugins</groupid> <artifactid>maven-compiler-plugin</artifactid> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> </plugins> </build> </project>
2、控制器类
使用springboot可以极大的简化我们开发web应用后台。在maven中引入了springboot之后，我们就可以来创建控制器类，这里我们使用最简洁的方式来创建相关类。核心代码比较简单，这里直接给出源代码：
package org.yelang.controller;
import java.util.hashmap;
import org.springframework.stereotype.controller;
import org.springframework.web.bind.annotation.getmapping;
import org.springframework.web.bind.annotation.responsebody;
@controller
public class testcontroller {
@getmapping("/test")
public string test() {
// 现在thymeleaf会查找test.html
return "test";
}
@getmapping("/testa")
@responsebody
public object testa() {
hashmap<string, object> data = new hashmap<string, object>();
data.put("name", "springboot");
data.put("version", "v2.7.18");
return data;
}
}关于如何在springboot中创建普通的接口和restful接口，springboot都是非常简单的，这里不做更多的赘述。上面第一个方式即是标准的mvc接口，最后返回一个页面给前端进行展示，第二个方式是返回一个对象信息。
3、thymeleaf 模板
接下来我们实现一个最简单的thymeleaf html页面，核心代码如下：
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>测试页面</title>
</head>
<body>
<h1>测试页面</h1>
<p>如果这个页面能正常显示，说明thymeleaf配置正确。</p>
<a href="/" rel="external nofollow" >返回首页</a>
</body>
</html>通过前面的controller中，通过test请求方法，就会跳转到这个具体的页面中。
4、配置文件 (application.yml)
在springboot中，约定大于配置是一条优化的规则，因此我们需要使用配置文件来进行应用程序的运行设置。比如程序运行端口号、访问路径、还有mvc模式下的访问页面配置，yml页面代码如下：
server:
port: 8088
servlet:
context-path: /bdsse
spring:
thymeleaf:
cache: false
prefix: classpath:/templates/
suffix: .html
mode: html
encoding: utf-8
check-template-location: true
mvc:
static-path-pattern: /static/**
logging:
level:
com.example.sse: debug5、主应用启动类
在springboot中，启动应用程序的方法很简单，直接就是main的方法方便快捷。
package org.yelang;
import org.springframework.boot.springapplication;
import org.springframework.boot.autoconfigure.springbootapplication;
@springbootapplication
public class sseclientapplication {
public static void main(string[] args) {
springapplication.run(sseclientapplication.class, args);
}
}二、项目运行
完成上述代码之后，我们就可以来运行项目。在启动应用程序后，同步测试一下应用接口的功能。
1、项目启动
系统启动后，在控制台中可以看到以下内容，说明应用程序启动成功。
2、restful接口测试
在控制台中看到以下消息就表示启动成功，大家可以访问应用接口。
started sseclientapplication in 4.953 seconds (jvm running for 5.594)
在浏览器中输入以下地址，回车看到以下内容：
三、thymeleaf集成的问题
尽管 spring boot 和 thymeleaf 的结合在理论上是完美的，但在实际开发过程中，开发者仍可能会遇到各种各样的问题。这些问题可能源于对框架特性的理解不够深入，也可能是因为开发环境的复杂性导致的配置冲突，甚至可能是由于一些隐藏的兼容性问题。这些问题如果不加以解决，可能会严重影响开发进度，降低应用的性能和稳定性。
1、异常详情
如果是集成了mvc方法时，我们需要跳转到具体的页面，需要跳转到test.html中。在浏览器中输入访问地址后，看到的并不是我们的预期，而是以下错误：
同时在我们的后台可以看到以下错误：
2025-11-21 22:23:49.561 error 11996 --- [nio-8088-exec-7] o.a.c.c.c.[.[.[.[dispatcherservlet] : servlet.service() for servlet [dispatcherservlet] in context with path [/bdsse] threw exception [circular view path [test]: would dispatch back to the current handler url [/bdsse/test] again. check your viewresolver setup! (hint: this may be the result of an unspecified view, due to default view name generation.)] with root cause javax.servlet.servletexception: circular view path [test]: would dispatch back to the current handler url [/bdsse/test] again. check your viewresolver setup! (hint: this may be the result of an unspecified view, due to default view name generation.) at org.springframework.web.servlet.view.internalresourceview.prepareforrendering(internalresourceview.java:210) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.view.internalresourceview.rendermergedoutputmodel(internalresourceview.java:148) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.view.abstractview.render(abstractview.java:316) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.dispatcherservlet.render(dispatcherservlet.java:1406) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.dispatcherservlet.processdispatchresult(dispatcherservlet.java:1150) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.dispatcherservlet.dodispatch(dispatcherservlet.java:1089) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.dispatcherservlet.doservice(dispatcherservlet.java:965) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.frameworkservlet.processrequest(frameworkservlet.java:1006) ~[spring-webmvc-5.3.31.jar:5.3.31] at org.springframework.web.servlet.frameworkservlet.doget(frameworkservlet.java:898) ~[spring-webmvc-5.3.31.jar:5.3.31] at javax.servlet.http.httpservlet.service(httpservlet.java:529) ~[tomcat-embed-core-9.0.83.jar:4.0.fr] at org.springframework.web.servlet.frameworkservlet.service(frameworkservlet.java:883) ~[spring-webmvc-5.3.31.jar:5.3.31] at javax.servlet.http.httpservlet.service(httpservlet.java:623) ~[tomcat-embed-core-9.0.83.jar:4.0.fr] at org.apache.catalina.core.applicationfilterchain.internaldofilter(applicationfilterchain.java:209) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.dofilter(applicationfilterchain.java:153) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.websocket.server.wsfilter.dofilter(wsfilter.java:51) ~[tomcat-embed-websocket-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.internaldofilter(applicationfilterchain.java:178) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.dofilter(applicationfilterchain.java:153) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.springframework.web.filter.requestcontextfilter.dofilterinternal(requestcontextfilter.java:100) ~[spring-web-5.3.31.jar:5.3.31] at org.springframework.web.filter.onceperrequestfilter.dofilter(onceperrequestfilter.java:117) ~[spring-web-5.3.31.jar:5.3.31] at org.apache.catalina.core.applicationfilterchain.internaldofilter(applicationfilterchain.java:178) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.dofilter(applicationfilterchain.java:153) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.springframework.web.filter.formcontentfilter.dofilterinternal(formcontentfilter.java:93) ~[spring-web-5.3.31.jar:5.3.31] at org.springframework.web.filter.onceperrequestfilter.dofilter(onceperrequestfilter.java:117) ~[spring-web-5.3.31.jar:5.3.31] at org.apache.catalina.core.applicationfilterchain.internaldofilter(applicationfilterchain.java:178) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.dofilter(applicationfilterchain.java:153) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.springframework.web.filter.characterencodingfilter.dofilterinternal(characterencodingfilter.java:201) ~[spring-web-5.3.31.jar:5.3.31] at org.springframework.web.filter.onceperrequestfilter.dofilter(onceperrequestfilter.java:117) ~[spring-web-5.3.31.jar:5.3.31] at org.apache.catalina.core.applicationfilterchain.internaldofilter(applicationfilterchain.java:178) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.applicationfilterchain.dofilter(applicationfilterchain.java:153) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.standardwrappervalve.invoke(standardwrappervalve.java:168) ~[tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.standardcontextvalve.invoke(standardcontextvalve.java:90) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.authenticator.authenticatorbase.invoke(authenticatorbase.java:481) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.standardhostvalve.invoke(standardhostvalve.java:130) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.valves.errorreportvalve.invoke(errorreportvalve.java:93) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.core.standardenginevalve.invoke(standardenginevalve.java:74) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.catalina.connector.coyoteadapter.service(coyoteadapter.java:342) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.coyote.http11.http11processor.service(http11processor.java:390) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.coyote.abstractprocessorlight.process(abstractprocessorlight.java:63) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.coyote.abstractprotocol$connectionhandler.process(abstractprotocol.java:928) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.util.net.nioendpoint$socketprocessor.dorun(nioendpoint.java:1794) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.util.net.socketprocessorbase.run(socketprocessorbase.java:52) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.util.threads.threadpoolexecutor.runworker(threadpoolexecutor.java:1191) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.util.threads.threadpoolexecutor$worker.run(threadpoolexecutor.java:659) [tomcat-embed-core-9.0.83.jar:9.0.83] at org.apache.tomcat.util.threads.taskthread$wrappingrunnable.run(taskthread.java:61) [tomcat-embed-core-9.0.83.jar:9.0.83] at java.lang.thread.run(unknown source) [na:1.8.0_171]
那么到底是什么原因导致的呢？通过排查问题来进行解决。
2、问题解决
如果大家在搜索引擎上查找问题，可以看到一下内容，
方法虽然多，但是基本很多都没有解决问题，都是把控制器的类型进行修改的，也有说明要调整配置文件。根据我的实测，都不是。在我这个场景中，实际问题是没有正确的引入thymeleaf库，因此需要解决的问题就是在pom.xml中引入相关资源，核心代码如下：
<!-- springboot集成thymeleaf模板 -->
<dependency>
<groupid>org.springframework.boot</groupid>
<artifactid>spring-boot-starter-thymeleaf</artifactid>
</dependency>引入以上资源后，在此运行程序后，再次在浏览器中输入访问地址后可以看到以下效果：
能看到以上页面，说明成功集成并且成功解决了以上的问题。
四、总结
以上就是本文的主要内容，为了帮助广大开发者更好地掌握 spring boot 2.7.8 与 thymeleaf 的集成，我们将从集成的基础开始，详细介绍如何在 spring boot 项目中引入 thymeleaf，并进行必要的配置以确保它们能够协同工作。本文的目标读者是那些已经具备一定 java 开发基础，并且对 spring boot 和 thymeleaf 有一定了解的开发者。行文仓促，定有不足之处，欢迎各位朋友在评论区批评指正，不胜感激。
到此这篇关于spring boot 2.7.8 集成 thymeleaf的最佳实践与常见问题讨论的文章就介绍到这了,更多相关spring boot集成 thymeleaf内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
发表评论