简单Thymeleaf应用使用@Controller时为何触发Circular view path [hello]错误
核心根因
报Circular view path [hello]根本不是你返回的视图名写错了,是Spring MVC压根没找到能渲染hello这个视图名的解析器,最后走了默认的转发逻辑,把请求又发回了自身的映射路径/hello,形成了循环分发。
这也能解释你换注解的测试现象:@RestController本质是@Controller+@ResponseBody,所有方法返回值直接写入HTTP响应体,完全跳过视图解析流程,自然不会触发这个循环检测的报错。
大概率踩中的具体错误
- 主启动类位置不对,Thymeleaf自动配置根本没生效
哪怕pom里老老实实引了spring-boot-starter-thymeleaf,只要Spring Boot启动类不在项目的根包下(比如把启动类放在controller包里,而项目根包是上层的业务包路径),就会导致组件扫描范围覆盖不到Thymeleaf的自动配置类,ThymeleafViewResolver压根不会被注册到Spring容器里。
这时候容器里只剩Spring MVC默认的视图解析器,它碰到字符串返回值,会直接把内容拼接成转发路径:你返回hello,它就生成转发地址/hello,和当前请求路径完全一致,直接触发循环报错。 - 模板文件路径错配
你说你在templates目录下建了hello.html,但实际常见的错配场景包括:- 文件错放到
static、public等其他资源目录下 - 文件名拼写错误(比如多打个字母、少打个字母)
- 手动在配置文件里修改了Thymeleaf的默认路径(比如把前缀写成
classpath:/static/、后缀改成.htm)
这些情况都会让Thymeleaf解析器找不到对应模板,最后退回到默认转发逻辑触发报错。
- 文件错放到
- DevTools热加载的类路径缓存异常
你引入了spring-boot-devtools,如果模板文件没被正确同步到devtools的类路径缓存里,也会出现解析器找不到模板的问题,一般清理target目录重启就能解决。
快速定位解决
- 检查主启动类位置,确保它在所有业务包的最上一层根包下,保证组件扫描能覆盖所有自动配置类
- 把配置文件里所有手动编写的Thymeleaf自定义配置全删掉,Spring Boot的自动配置已经适配好了正确的前缀、后缀、模板模式参数,手动修改反而容易出错
- 核对
hello.html的绝对路径,必须满足src/main/resources/templates/hello.html,中间不要嵌套多余的子目录 - 清除项目的target缓存目录,重启开发服务重新加载资源
很多网上的教程会教你在方法上加
@ResponseBody或者把返回值改成字符串路径来“解决”这个问题,本质都是直接跳过视图解析流程,根本没解决Thymeleaf解析器未生效的核心问题,最后Thymeleaf模板永远无法正常渲染。
内容的提问来源于stack exchange,提问作者Bhumesh
相关产品推荐
相关产品推荐

