SpringBoot整合thymeleaf 报错的解决方案

更新时间：2021年08月03日 09:45:06 作者：熊熊爱绵羊

这篇文章主要介绍了SpringBoot整合thymeleaf 报错的解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教

近日在springboot项目中使用thymeleaf时，莫名报了以下错误：

在网上查找文章明白了报错的原因，这是由于如果使用thymeleaf 为模板，那么解析时就要求html必须为严格的html5格式，即必须有完整的结束标记，不然就会报错。

在html页面中，诸如input,meta，link等标签，是可以不用闭合就可以被解析的（自闭合的），但是由于这里严格要求html5格式

于是解决办法如下：

1）在报错的标签上加入结束标签。

2）修改为不严格的模式。

在配置文件中加入如下配置：

mode: LEGACYHTML5

使用该配置，需要加入以下依赖：

  <dependency>
      <groupId>net.sourceforge.nekohtml</groupId>
      <artifactId>nekohtml</artifactId>
      <version>1.9.22</version>
 </dependency>

3）修改高版本的thymeleaf版本。

低版本(即spring-boot-starter-parent的版本) SpringBoot 默认使用的thymeleaf 版本为 2.1版本，该版本无法识别html5中常见的自闭合标签。官方原话，可以使用高版本thymeleaf，并通过配置来解决该问题。

可以在pom文件中强行指定thymeleaf的版本，如下：

<thymeleaf.version>3.0.9.RELEASE</thymeleaf.version>
<thymeleaf-layout-dialect.version>2.1.1</thymeleaf-layout-dialect.version>

然后再配置文件中配置如下：

thymeleaf:
    mode: HTML

事实上，我在使用高版本的springBoot版本(2.0.4.RELEASE)时，并没有遇到这个情况，而该项目中使用的是1.5.9版本的springboot ，这也从侧面证明该方法可行。

Springboot 集成 Thymeleaf 及常见错误

Thymeleaf模板引擎是springboot中默认配置，与freemarker相似，可以完全取代jsp，在springboot中，它的默认路径是src/main/resources/templates 静态文件css, js 等文件默认路径是src/main/resources/static，所有项目中如果没有这个目录需要手动加上了

首先我们要在pom.xml文件中添加依赖

<!-- thymeleaf 模板引用  -->
<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-thymeleaf</artifactId>  </dependency>

引用之后我们就来测试一下，在pom.xml中引入依赖之后。你完全可以不用配置（也秉承了springboot 约定优于配置）当然你如果需要自定义一些属性，你可以在application.properties 中添加配置。

测试类@Controller

/**
 * @author pillarzhang
 * @date 2019-06-03
 */
@Controller
public class loginController {
    @RequestMapping("/index")
    public String index(){
        return "index";
    }
}

Index,html 页面如下

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Insert title here</title>
</head>
<body>
<p style="color:red">hello world</p>
</body>
</html>

启动项目，输入http://localhost:8081/index 即可看到如下页面

这就成功的集成了Thymeleaf。

注意：前面也说了，如果你不配置任何属性依然可以使用，当然你也可以自己设置，在配置文件中application.properties 设置相应的属性

spring.thymeleaf.prefix=classpath:/templates/  设置thymeleaf路径默认为src/main/resources/templates
spring.thymeleaf.suffix=.html  设置thymeleaf模板后缀
spring.thymeleaf.content-type=text/html
spring.thymeleaf.cache=false  是否开启缓存默认为true
spring.thymeleaf.mode=LEGACYHTML5  设置thymeleaf严格校验
spring.thymeleaf.encoding=UTF-8    设置编码

1、配置完成之后一定要注意路径地址是否正确，

2、一定要用@Controller，如果使用@RestController，有可能返回return中的一串字符

3、方法前不要加@ResponseBody，加这个注释相当于@RestController, 返回一串字符串同上

4、如果载application.properties重配置属性，一定要注意是否书写有误，不能多空格否则有可能会报如下错误：

至此，springboot集成thymeleaf 就完成了，虽然中间遇到了一些小问题，还好解决了。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Win10 Java jdk14.0.2安装及环境变量配置详细教程
这篇文章主要介绍了Win10 Java jdk14.0.2安装及环境变量配置,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-08-08
Java web项目中的强制登录功能实现代码
本文给大家分享Java web项目中的强制登录功能实现代码，为了避免直接进入项目中存在的页面，使用filter过滤器，代码简单易懂，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友参考下吧
2021-11-11
Java中特殊运算符及其应用详解
当涉及位操作和位级运算时,Java 提供了一组特殊的运算符,即左移（<<）和右移（>>）运算符,下面小编就带大家深入了解一下它们的具体应用吧
2023-08-08
Java枚举(enum) 详解7种常见的用法
这篇文章主要介绍了Java枚举(enum) 详解7种常见的用法,具有一定的参考价值，有需要的可以了解一下。
2016-11-11
Java 8 开发的 Mybatis 注解代码生成工具
MybatisAnnotationTools 是基于 Java8 开发的一款可以用于自动化生成 MyBatis 注解类的工具，支持配置数据源、类路径，表名去前缀、指定类名前后缀等功能.这篇文章主要介绍了Java 8 开发的 Mybatis 注解代码生成工具 ,需要的朋友可以参考下
2019-07-07
Spring入门基础之依赖注入
Idea中使用@Autowire注解会出现提示黄线，强迫症患者看着很难受，使用构造器注入或者setter方法注入后可解决，下面我们一起来看看
2022-07-07
Java中的DecimalFormat用法解析
这篇文章主要介绍了Java中的DecimalFormat用法解析,DecimalFormat是Java中用于格式化数字的类,它提供了一种简单而灵活的方式来格式化数字,包括指定小数位数、千位分隔符、货币符号等,需要的朋友可以参考下
2023-10-10
java如何确定一个链表有环及入口节点
这篇文章主要介绍了java如何确定一个链表有环及入口节点，想了解数据结构的同学可以参考下
2021-04-04
java 在file的尾部添加数据的两种方法总结
这篇文章主要介绍了java 在file的尾部添加数据的两种方法总结的相关资料,这里提供了两种在file尾部添加数据的方法，希望能帮助到大家，需要的朋友可以参考下
2017-09-09
java利用socket通信实现Modbus-RTU通信协议的示例代码
这篇文章主要介绍了java利用socket通信实现Modbus-RTU通信协议的示例代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-04-04