Spring Boot启动时Thymeleaf模板路径警告问题排查

常见原因及修复方案 #

1. 实际目录缺失或拼写错误 #

• 确认src/main/resources下存在**templates文件夹**，注意大小写（类Unix系统区分大小写）。如果不存在，手动创建；如果拼写错误（如写成template），修正目录名称。

2. 资源未被正确识别/打包 #

• IDE配置检查：IntelliJ需将src/main/resources标记为「Resources Root」；Eclipse需确保该目录在Build Path的资源列表中。
• 重新构建项目：执行mvn clean package（Maven项目）或./gradlew clean build（Gradle项目），清理旧构建产物后重新打包。解压生成的jar包，验证BOOT-INF/classes/templates是否存在。

3. 自定义配置覆盖默认行为 #

• 检查是否存在自定义TemplateResolver Bean，若有需确保其prefix属性为classpath:/templates/，且未错误开启checkExistence（开启后会严格检查模板路径）。
• 尝试移除application.properties中的spring.thymeleaf.prefix配置（默认值即为classpath:/templates/），排查是否因配置冲突导致警告。

4. 临时规避方案（仅适用于无模板场景） #

若项目暂未添加模板文件，可关闭路径检查：

spring.thymeleaf.check-template-location=false

注意：模板文件添加后需移除该配置，避免隐藏真实路径问题。

内容的提问来源于stack exchange，提问作者cristian porrety