You need to enable JavaScript to run this app. Spring Boot集成Mustache无法解析视图页面运行404问题排查求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 18:57:03