Spring Boot项目@GetMapping返回HTML报404白页如何解决

1. 检查是否引入模板引擎依赖 #

Spring Boot无法直接解析resources/templates下的静态HTML页面，必须依赖模板引擎实现视图解析，最常用的是Thymeleaf，需在pom.xml（Maven）或build.gradle（Gradle）中添加对应依赖：
Maven依赖示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

2. 检查模板引擎配置是否正确 #

查看application.properties或application.yml配置文件，确认没有修改默认的Thymeleaf配置：

• 默认前缀：spring.thymeleaf.prefix=classpath:/templates/
• 默认后缀：spring.thymeleaf.suffix=.html
• 确认没有配置spring.thymeleaf.enabled=false关闭模板引擎

3. 检查编译后文件是否存在 #

查看项目构建后的target/classes/templates目录（Maven项目）或build/resources/main/templates目录（Gradle项目），确认hello.html文件是否被正确编译打包到对应路径。如果不存在，执行重新构建操作即可：

• IDEA中可按快捷键Ctrl+F9重新编译项目
• 命令行执行mvn clean install或gradle build完成构建

4. 额外校验项 #

• 确认控制器使用@Controller注解而非@RestController，且接口方法没有添加@ResponseBody注解，否则会直接返回字符串而非解析视图
• 确认控制器类所在包在启动类的扫描范围内，@SpringBootApplication注解默认扫描启动类所在包及所有子包，你当前项目中控制器和启动类同属com.example.springplay包，该配置无问题

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