SpringBoot应用中Thymeleaf模板无法正常工作求助

核心问题分析及修复步骤 #

• Kotlin文件扩展名错误：你的Controller文件位于src/main/kotlin/net/iceja/controller目录，但文件名是FrontPageController.java——Kotlin代码文件必须使用.kt扩展名，否则Spring无法识别并加载这个Controller组件。
• 模板文件缺失或路径错误：确认index模板文件是否存在于src/main/resources/templates目录下（比如Thymeleaf默认读取此目录下的.html文件），且文件名正确（如index.html）。
• Component扫描范围不足：检查Spring Boot主类的@SpringBootApplication注解所在包，若主类不在net.iceja上层包，需添加@ComponentScan(basePackages = "net.iceja")确保Controller被扫描到。
• Controller注解与映射错误：确认Controller类添加了@Controller注解，且存在@GetMapping("/")这样的根路径映射方法，返回值为"index"。

快速修复流程 #

1. 将FrontPageController.java重命名为FrontPageController.kt，修正文件扩展名。
2. 检查src/main/resources/templates/index.html是否存在，路径和文件名无误。
3. 验证主类的Component扫描范围，确保覆盖net.iceja.controller包。
4. 重启Spring Boot应用，重新访问localhost:8080。

内容的提问来源于stack exchange，提问作者Ekaterina Ivanova iceja.net