Spring Boot中无法访问index.html页面的问题求助

问题分析 #

你的控制器通过@Controller和@GetMapping("/")返回"index"，期望跳转至index.html页面但无法加载。核心原因是：@Controller返回的字符串需要通过模板引擎解析对应视图文件，而非直接访问静态资源目录。

具体解决方案 #

1. 调整index.html存放位置 #

Spring Boot默认模板文件目录为src/main/resources/templates/，将index.html移动到该目录下，控制器返回的"index"会自动匹配templates/index.html。

2. 引入模板引擎依赖 #

项目未添加模板引擎时，@Controller无法将返回字符串解析为HTML视图。推荐使用Spring Boot官方推荐的Thymeleaf，添加对应依赖：

Maven项目（pom.xml）

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

Gradle项目（build.gradle）

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

3. 检查自定义视图解析器配置（如有） #

如果手动配置过视图解析器，需确保前缀、后缀设置正确。Thymeleaf默认配置如下，若修改过需保证路径指向index.html所在位置：

spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

4. 清理缓存并重启项目 #

IDE或项目编译缓存可能导致文件未被正确识别，清理IDE缓存（如IDEA：File -> Invalidate Caches...）后重启项目，再尝试访问。

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