当前位置：首页 > article >正文

在SpringBoot中访问 static 与 templates 目录下的内容

article 2026/1/21 20:38:12

在使用 Spring Boot 开发 Web 应用时，我们经常需要向用户展示 HTML 页面。这些 HTML 文件通常存放在 src/main/resources/static 或 src/main/resources/templates 目录下。然而，这两个目录下的文件访问方式有所不同。本篇博文将详细介绍如何配置并访问这两个目录中的 HTML 文件。

步骤一：添加 Thymeleaf 依赖 (处理 Templates 目录)

templates 目录通常用于存放视图模板，这些模板往往需要后端数据渲染。Spring Boot 推荐使用模板引擎来处理，Thymeleaf 就是其中一个流行的选择。如果你的项目需要处理 templates 下的 HTML，首先要确保添加了 Thymeleaf 依赖。

方法一：修改 pom.xml

在你的 Maven 项目的 pom.xml 文件中的 <dependencies> 部分添加以下依赖：

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

方法二：使用 Spring Initializr

如果你是通过 Spring Initializr (https://start.spring.io/) 创建项目，可以直接在依赖项（Dependencies）部分搜索并勾选 Thymeleaf：

添加此依赖后，Spring Boot 会自动配置 Thymeleaf 模板引擎。

步骤二：配置静态资源路径 (可选但建议了解)

Spring Boot 默认会从几个标准位置加载静态资源，包括 classpath:/static/。通常情况下，默认配置已经够用。但如果你想明确指定或自定义静态资源的查找路径，可以在 application.properties 或 application.yml 文件中进行配置。

在 application.properties 中配置：

# 指定静态资源的位置，多个路径用逗号分隔
spring.web.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/

在 application.yml 中配置：

spring:web:resources:# 指定静态资源的位置列表static-locations:- classpath:/META-INF/resources/- classpath:/resources/- classpath:/static/- classpath:/public/

这个配置告诉 Spring Boot 在应用的类路径（classpath）下的这些目录中查找静态文件（如 HTML, CSS, JavaScript, 图片等）。

步骤三：访问不同目录下的 HTML 文件

访问 `static` 目录下的 HTML 文件

放置在 src/main/resources/static 目录下的文件被视为纯静态资源。访问这些文件非常简单直接：

访问方式： 启动应用后，在浏览器中通过 根路径/文件名 的方式即可访问。
示例： 如果在 static 目录下有一个 about.html 文件，你可以通过访问 http://<你的服务器地址>:<端口号>/about.html 来直接查看它。

访问 `templates` 目录下的 HTML 文件

src/main/resources/templates 目录主要用于存放需要后端处理和渲染的视图模板。

直接访问限制： 通常情况下，除了 templates/index.html 可能在特定配置下作为应用的默认欢迎页（通过访问根路径 / 显示）之外，该目录下的其他 HTML 文件不能像 static 目录下的文件那样通过 根路径/文件名 直接访问。
通过 Controller 访问（标准方式）： 访问 templates 目录下的 HTML 文件（例如 index2.html），需要创建一个 Spring MVC Controller 来处理特定的 URL 请求，并返回对应的视图名称。

示例 Controller 代码：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;@Controller // 声明这是一个 Spring MVC 控制器
public class FirstController { // 类名建议使用大驼峰命名法// 将 HTTP GET 请求 "/testConnection" 映射到这个 hello 方法@RequestMapping("/testConnection")public String hello() {// 返回字符串 "index2.html"// 当使用 Thymeleaf 时，Spring Boot 会查找 /src/main/resources/templates/ 目录下的 index2.html 文件// 并使用 Thymeleaf 引擎进行渲染后返回给浏览器// 注意：更常见的 Thymeleaf 用法是只返回逻辑视图名 "index2"，// Thymeleaf 会自动根据配置添加前缀(classpath:/templates/)和后缀(.html)。// 但为了与原始说明保持一致，这里我们返回完整的文件名。return "index2.html";}
}

工作流程：

用户在浏览器中访问 http://<你的服务器地址>:<端口号>/testConnection。
Spring Boot 侦测到这个请求，并根据 @RequestMapping("/testConnection") 注解，将请求分发给 FirstController 的 hello() 方法。
hello() 方法执行并返回字符串 "index2.html"。
由于项目中引入了 spring-boot-starter-thymeleaf，Spring Boot 的视图解析器会识别这个字符串为视图模板的名称。
视图解析器（结合 Thymeleaf）会在配置的模板路径（默认为 classpath:/templates/）下查找名为 index2.html 的文件。
找到模板文件后，Thymeleaf 引擎会对其进行处理（如果模板中包含动态内容指令），并将最终渲染生成的 HTML 内容作为响应返回给浏览器。

总结

static 目录： 用于存放纯静态资源（HTML, CSS, JS, 图片等）。默认配置下，可以通过 /<文件名> 直接在浏览器中访问。
templates 目录： 用于存放视图模板（通常是 HTML 文件，可能包含动态内容）。一般需要通过 Controller 映射 URL 请求，返回逻辑视图名，由模板引擎（如 Thymeleaf）渲染后才能访问。index.html 有时可作为特殊情况下的欢迎页面。

希望这篇博文能帮助你理解和正确访问 Spring Boot 项目中不同目录下的 HTML 文件！

参考文档：

龙城桥少的 SpringBoot 如何访问templates目录下的html页面