Spring Boot 静态资源路径映射

目的是让前端能通过 HTTP 访问你本地硬盘上的视频、封面、头像文件

一、核心背景：为什么需要这个配置？

Spring Boot 默认只暴露 src/main/resources/static 等目录下的静态资源，而你的视频 / 封面 / 头像存在本地硬盘（C:\Users\Administrator\Desktop\file\...），前端无法直接访问。

二、配置项 & 注解注入的核心解析

1. YAML 配置文件的结构含义

app:  # 自定义根命名空间（避免配置项冲突）
  video:  # 子命名空间：视频相关配置
    permanent-path: C:\Users\Administrator\Desktop\file\videos\  # 视频文件的本地物理路径
  cover:  # 子命名空间：封面相关配置
    permanent-path: C:\Users\Administrator\Desktop\file\covers\  # 封面文件的本地物理路径
  avatar:  # 子命名空间：头像相关配置
    permanent-path: C:\Users\Administrator\Desktop\file\avatars\  # 头像文件的本地物理路径

• app：是你自定义的根命名空间 ，目的是把项目的自定义配置归类，避免和 Spring 内置配置（如 spring.datasource）冲突；
• cover/video/avatar：是 app 下的子命名空间，进一步细分不同类型文件的配置，让配置结构更清晰；
• permanent-path：是具体的配置项 key，值是本地硬盘的物理路径（注意 Windows 路径用 \，配置中要写转义后的 \ 或直接用 /）。

这个配置的作用是：把本地硬盘的物理路径，映射成前端可访问的 HTTP 路径 （比如 http://localhost:8080/covers/xxx.jpg → 对应本地 C:\Users\Administrator\Desktop\file\covers\xxx.jpg）。

2. @Value 注解：精准注入配置值

// 注入 app.cover.permanent-path 对应的配置值 → 即 C:\Users\Administrator\Desktop\file\covers\
@Value("${app.cover.permanent-path}")
private String permanentCoverDir;

• ${app.cover.permanent-path}：Spring 的占位符语法 ，规则是 ${根命名空间.子命名空间.配置项key}，精准匹配 YAML 中的配置路径；
• @Value：Spring 核心注解，作用是把配置文件中对应占位符的值，注入到当前类的成员变量中；
• 最终效果：permanentCoverDir 变量的值会被自动赋值为 C:\Users\Administrator\Desktop\file\covers\，无需手动写死路径（解耦配置和代码）。

三、资源映射的核心逻辑（addResourceHandlers 方法）

// 封面路径映射：前端访问 /covers/xxx.jpg → 对应本地 permanentCoverDir 路径下的 xxx.jpg
registry.addResourceHandler("/covers/**")
        .addResourceLocations("file:" + permanentCoverDir)
        .setCachePeriod(3600);

逐个参数解析：

1. addResourceHandler("/covers/**")：定义前端访问的 HTTP 路径规则 ，/** 表示 "匹配 /covers/ 下的所有子路径"（比如 /covers/1.jpg、/covers/2025/abc.png 都匹配）。
2. addResourceLocations("file:" + permanentCoverDir)：
   • file:：是 Spring 识别 "本地文件系统路径" 的前缀（必须加，否则会被当成 classpath 路径）；
   • 拼接后的值是 file:C:\Users\Administrator\Desktop\file\covers\，表示前端访问 /covers/** 时，Spring 会去这个本地路径找文件。
3. setCachePeriod(3600)：设置浏览器缓存时间（单位：秒），缓存 1 小时可以减少重复请求，优化前端访问速度（比如用户重复看同一张封面，不用每次都从服务器读取）

四、完整映射示例（一目了然）

前端访问路径	映射到本地物理路径	对应配置 / 代码
http://localhost:8080/videos/1.mp4	C:\Users\Administrator\Desktop\file\videos\1.mp4	app.video.permanent-path
http://localhost:8080/covers/1.jpg	C:\Users\Administrator\Desktop\file\covers\1.jpg	app.cover.permanent-path
http://localhost:8080/avatars/2.png	C:\Users\Administrator\Desktop\file\avatars\2.png	app.avatar.permanent-path