SpringBoot访问HTML页面的三种核心方式：默认路径、自定义配置与Controller跳转

SpringBoot默认文件路径访问机制

理解SpringBoot的资源映射机制是访问HTML的前提。SpringBoot对两类主要资源做了区分：

• 模板文件（Templates）： 默认存放于 classpath:/templates/ 目录下。这些文件通常包含动态数据逻辑，受视图解析器保护，不直接对外暴露。
• 静态资源（Static）： 默认存放在 classpath:/static/ 及其子目录下。这是JS、CSS、图片和无动态逻辑的纯HTML文件的存放位置。

若希望HTML页面被作为静态资源直接访问，需将其放置在 static 目录下。此时，无需编写后端代码，浏览器即可通过相对路径直接请求。

假设项目结构如下：

src/main/resources/static/view/index.html

访问该页面时，直接在浏览器输入： http://localhost:端口号/view/index.html 即可显示。图片展示了文件放置的具体层级结构：

自定义文件路径访问：开放templates目录

通常情况下，templates 目录下的内容不允许直接通过URL访问，必须经过Controller或视图解析器处理。这主要是出于安全考虑，防止后台模板文件泄露或被直接执行。

但在某些特定场景下（如纯静态前端部署），你可能需要直接访问 templates 中的HTML文件。可以通过修改配置文件，将 templates 加入静态资源的搜索路径来实现。

在 application.yml 中添加以下配置：

spring:
  resources:
    static-locations: 
      - classpath:/META-INF/resources/
      - classpath:/resources/
      - classpath:/static/
      - classpath:/public/
      - classpath:/templates/

或者使用 application.properties 格式：

spring.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,classpath:/templates/

注意： 添加上述配置后，启动项目并在浏览器访问 /templates/xxx.html 即可直接加载。此操作打破了默认的隔离安全机制，请确保 templates 目录中不包含敏感的后台逻辑或用户数据接口。

通过Controller控制器与Thymeleaf跳转访问

这是SpringBoot中最标准、最推荐的Web开发模式。它利用了MVC分层思想，通过Controller接收请求，指定返回的逻辑视图名称，再由视图解析器定位到实际的HTML文件。

第1步：引入Thymeleaf依赖

为了使SpringBoot能够解析模板文件（如 .html 后缀），需要在 pom.xml 中引入 spring-boot-starter-thymeleaf 依赖：

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

第2步：定义Controller并返回视图名

创建一个继承自 @Controller 的类，使用 @RequestMapping 映射请求路径，并返回字符串形式的视图名称。SpringBoot会默认在 templates 目录下查找名为返回值的HTML文件。

@Controller
public class TestController {

    @RequestMapping("/test")
    public String test() {
        // 返回 "login1"，最终指向 templates/login1.html
        return "/login1";
    }
}

在该配置下，访问 http://localhost:端口号/test，服务器内部会自动渲染 templates/login1.html 并响应给客户端。

通过这种方式，你可以轻松地在HTML页面中嵌入业务逻辑数据（如表单提交、用户信息等），实现前后端的高效交互。