springboot整合thymeleaf页面跳转失败问题 Exception processing template “xxx“: Error resolving template ...

最新推荐文章于 2024-09-23 15:39:16 发布

uniquewdl

最新推荐文章于 2024-09-23 15:39:16 发布

阅读量1.4w

点赞数 20

分类专栏： java编程 web开发 java开发文章标签： spring boot thymeleaf 微服务

本文链接：https://blog.csdn.net/uniqueweimeijun/article/details/111175968

版权

web开发同时被 3 个专栏收录

145 篇文章 1 订阅

订阅专栏

java编程

134 篇文章 1 订阅

订阅专栏

java开发

55 篇文章 0 订阅

订阅专栏

本文记录了在Spring Boot项目中整合Thymeleaf时遇到的模板无法解析的问题，分析了错误原因，即配置文件中Thymeleaf前缀缺少了一个'/'。修复这个问题后，项目正常运行。同时，文章提到了使用ModelAndView返回类型设置视图名称和传递参数的方法，并强调了查看源码对于解决问题的重要性。

摘要由CSDN通过智能技术生成

问题

[THYMELEAF][http-nio-8989-exec-1] Exception processing template "login1": Error resolving template [login1], template might not exist or might not be accessible by any of the configured Template Resolvers

org.thymeleaf.exceptions.TemplateInputException: Error resolving template [login1], template might not exist or might not be accessible by any of the configured Template Resolvers
	at org.thymeleaf.engine.TemplateManager.resolveTemplate(TemplateManager.java:869) ~[thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]
	at org.thymeleaf.engine.TemplateManager.parseAndProcess(TemplateManager.java:607) ~[thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]

产生背景

最近在搞一个关于静态化的东西，利用springboot整合thymeleaf，但是刚出手就受到一些打击，经历了很久的折磨，下边是经历回顾…

建立项目
加依赖

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

搞配置（配置有坑先别抄）

###ThymeLeaf配置
spring:
  thymeleaf:
    #模板的模式，支持 HTML, XML TEXT JAVASCRIPT
    mode: HTML5
    #编码 可不用配置
    encoding: UTF-8
    #内容类别,可不用配置
    #开发配置为false,避免修改模板还要重启服务器
    cache: false
    #配置模板路径，默认是templates，可以不用配置
    prefix: classpath:/templates```

写个简单html页面（文件名叫login1.html）,位置resources/templates/login1.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>title</title>
</head>
<body>
<form  class="form-signin" action="/form" method="post">
    <h2 class="form-signin-heading">用户登录</h2>
    <table>
        <tr>
            <td>用户名:</td>
            <td><input type="text" name="username"  class="form-control"  placeholder="请输入用户名"/></td>
        </tr>
        <tr>
            <td>密码:</td>
            <td><input type="password" name="password"  class="form-control" placeholder="请输入密码" /></td>
        </tr>
        <tr>
            <td colspan="2">
                <button type="submit"  class="btn btn-lg btn-primary btn-block" >登录</button>
            </td>
        </tr>
    </table>
</form>
</body>
</html>

控制器

@Controller
@RequestMapping("")
public class IndexController {
	@RequestMapping(value = "login")
	public String test(){
	return "login1";
	}
	}

期望

期望结果

实际结果

在这里插入图片描述
[THYMELEAF][http-nio-8989-exec-1] Exception processing template “success”: Error resolving template [success], template might not exist or might not be accessible by any of the configured Template Resolvers

org.thymeleaf.exceptions.TemplateInputException: Error resolving template [success], template might not exist or might not be accessible by any of the configured Template Resolvers
at org.thymeleaf.engine.TemplateManager.resolveTemplate(TemplateManager.java:869) ~[thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.thymeleaf.engine.TemplateManager.parseAndProcess(TemplateManager.java:607) ~[thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1098) [thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1072) [thymeleaf-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.thymeleaf.spring5.view.ThymeleafView.renderFragment(ThymeleafView.java:362) [thymeleaf-spring5-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.thymeleaf.spring5.view.ThymeleafView.render(ThymeleafView.java:189) [thymeleaf-spring5-3.0.11.RELEASE.jar:3.0.11.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.render(DispatcherServlet.java:1373) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.processDispatchResult(DispatcherServlet.java:1118) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1057) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:943) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1006) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:898) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]
at javax.servlet.http.HttpServlet.service(HttpServlet.java:626) [tomcat-embed-core-9.0.39.jar:4.0.FR]
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:883) [spring-webmvc-5.2.10.RELEASE.jar:5.2.10.RELEASE]

一开始思路就是，版本不兼容，yml配置有问题（缓存cache,context-type,是不是html5l类型）等…看来一下网上，反正是各种喷，还有人说要加 @ResponseBody 或 @RestControll ，真是想喷人，哈哈哈。

这里不卖关子了。其实主要就是在yml配置文件里关于配置前缀的内容少写了一个"/"。正确写法为：

prefix: classpath:/templates/

改成这样就可以正常运行了。

简单分析一下

我们可以浅浅看下源码，因为是springboot整合中所涉及到配置文件的，都会有一个xxxProperties的映射类，通过
ThymeleafProperties.class这个类可以发现


@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {

	private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;

	public static final String DEFAULT_PREFIX = "classpath:/templates/";

	public static final String DEFAULT_SUFFIX = ".html";

	/**
	 * Whether to check that the template exists before rendering it.
	 */
	private boolean checkTemplate = true;

	/**
	 * Whether to check that the templates location exists.
	 */
	private boolean checkTemplateLocation = true;

	/**
	 * Prefix that gets prepended to view names when building a URL.
	 */
	private String prefix = DEFAULT_PREFIX;

	/**
	 * Suffix that gets appended to view names when building a URL.
	 */
	private String suffix = DEFAULT_SUFFIX;

	/**
	 * Template mode to be applied to templates. See also Thymeleaf's TemplateMode enum.
	 */
	private String mode = "HTML";

	/**
	 * Template files encoding.
	 */
	private Charset encoding = DEFAULT_ENCODING;

	/**
	 * Whether to enable template caching.
	 */
	private boolean cache = true;

	/**
	 * Order of the template resolver in the chain. By default, the template resolver is
	 * first in the chain. Order start at 1 and should only be set if you have defined
	 * additional "TemplateResolver" beans.
	 */
	private Integer templateResolverOrder;

	/**
	 * Comma-separated list of view names (patterns allowed) that can be resolved.
	 */
	private String[] viewNames;```

可以发现，该类对于上述yml配置有自己的缺省值，且prefix值为：classpath:/templates/

其实我们在yml中不用加任何配置也可以正常运行，亲测。
最后扩展一下，我们也可以采用ModelAndView的返回类型，在控制器中设置视图名称，也可以进行找到，同时可以在ModelAndView中设置一些属性传递到前端。示例如下：

欢迎<span style="color: red" th:text="${username}"></span>

	@RequestMapping(value = "login")
	public ModelAndView test(){
		ModelAndView modelAndView=new ModelAndView();
		modelAndView.addObject("username","unique");
		modelAndView.setViewName("login1");
		return modelAndView;
	}

在这里插入图片描述
所以，有时候实在中有些问题还是可以尝试看下源码进行思考。