Gradle构建Spring Boot项目无法映射HTML模板问题求助

一、@Controller模板映射失败解决方案 #

1. 补充模板引擎依赖 #

Spring Boot无法直接解析返回的模板名称，必须引入模板引擎依赖。若使用Thymeleaf，在build.gradle中添加：

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'

添加后执行gradle build并重启项目。

2. 修正模板文件路径 #

确保HomePage.html放在src/main/resources/templates/目录下——这是Spring Boot默认的模板扫描路径，static目录仅用于存放CSS、JS、图片等静态资源，不能放置模板文件。

3. 核对文件名大小写 #

返回的字符串是"HomePage"，需确保模板文件名为HomePage.html，注意大小写一致性（Linux/macOS系统对文件名大小写敏感）。

4. 排查请求处理异常 #

开启Web请求DEBUG日志，在application.properties中添加：

logging.level.org.springframework.web=DEBUG

重启项目后访问/home，查看控制台日志，确认请求是否到达Controller、service.listar()是否抛出异常，以此定位问题。

5. 检查映射冲突 #

确认没有其他Controller的@GetMapping("/home")映射与当前Controller冲突，避免请求被拦截。

二、JPA警告处理 #

在application.properties中添加配置，禁用默认开启的Open Session In View模式并消除警告：

spring.jpa.open-in-view=false

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