SpringBoot 整合模板引擎 Thymeleaf 页面跳转失败的解决方案

1. 出错现象

我们知道 Thymeleaf 模板引擎规定的文件路劲应该是在 templates 目录下面的。

但是笔者在开发的过程中，满足了上述要求但是还是没能映射成功。

我们来看看 index.html 里面有什么东西

在来看看访问 localhost:8080/index 时打开的网页是什么样子的：

它这里是直接显示了字符串 index，而不是进行模板引擎的解析。说明此处出现了错误。

2. 解决方案

首先看看有没有导入 Thymeleaf 的依赖座标

<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring5</artifactId>
</dependency>
<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-java8time</artifactId>
</dependency>

笔者之前就导入了，所以这个不是出错的原因。

最后经测试，发现是 @RestController 惹的祸。其原因是：但是如果使用@RestController注解，视图解析器InternalResourceViewResolver会失效，无法解析html、jsp页面进而跳转到指定的页面，而是返回return的内容。

因此解决方法就是将 @RestController 改成 @Controller

再次访问 localhost:8080/index

发现解析成功，这样问题就解决了。

3. 反思提升

但是我们为了编码的方便，我们一般都会用 @RestController 来替代 @Controller + @ResponseBody。

所以如果我们一定要用 @RestController 注解的话，该如何实现页面的跳转呢？

刚刚提到使用 @RestController 注解的话，视图解析器会失效，如果返回值是 String 的话，那么就只会返回 String 的内容。所以这里肯定不能返回 String。

经笔者学习研究，发现可以用以下方法实现页面的跳转：

@RestController
public class IndexController {

    @GetMapping("/index")
    public ModelAndView index(){
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("index");
        return modelAndView;
    }
}

我们改用返回一个 ModelAndView 对象，这样就可以实现页面跳转了。

运行后重新访问路径，结果是一样的。