Spring Boot集成Mustache无法解析视图页面运行404问题排查求助
问题排查解决方案
1. 模板文件路径与命名校验
- 必须将
index.mustache文件存放在src/main/resources/templates/目录下,注意目录名拼写不能出错,文件名大小写要和Controller返回的视图名完全匹配 - 模板文件不能放在
static目录下:该目录仅存放无需后端渲染的静态资源(js、css、静态html等),Mustache作为服务端渲染模板必须放在templates目录下
2. Mustache配置校验
Spring Boot 2.1.x版本对Mustache的默认自动配置如下,无需手动添加即可生效,如果你在application.properties/application.yml中自定义过相关配置,请核对是否和默认值一致:
# 模板文件前缀路径 spring.mustache.prefix=classpath:/templates/ # 模板文件后缀 spring.mustache.suffix=.mustache # 开启Mustache自动配置 spring.mustache.enabled=true
3. 解决IntelliJ IDEA "can not resolve Mvc view" 报错
这个报错是IDE的静态识别问题,不影响项目实际运行,可通过以下操作修复:
- 右键点击
src/main/resources文件夹,选择Mark Directory as->Resources Root,将该目录标记为资源根目录 - 清理IDE缓存重启:点击顶部菜单栏
File->Invalidate Caches...,勾选Clear file system cache and local history后重启IDE即可
4. 运行时404问题排查
4.1 检查MVC自动配置是否被覆盖
如果你在项目中使用了@EnableWebMvc注解,该注解会强制禁用Spring Boot的MVC自动配置,包括Mustache视图解析器的自动注册,直接删除该注解即可恢复默认配置。
4.2 检查Controller的扫描路径
你的IndexController所在包为springboot.web,Spring Boot默认只会扫描启动类所在包及其子包下的Bean,如果你的启动类在com.jojoldu.book包下,会扫描不到Controller,两种解决方法:
- 将
IndexController移动到启动类所在包的子包下 - 在启动类上添加
@ComponentScan(basePackages = {"springboot.web", "你的启动类所在包名"}),手动指定扫描路径
内容的提问来源于stack exchange,提问作者baeyeongbin
相关产品推荐
相关产品推荐

