Spring Boot 通过实现 WebMvcConfigurer 的 addResourceHandlers 方法，将外部磁盘路径（如 /data/static/images/）映射为 HTTP 可访问的静态资源路径（如 /images/**），支持自动创建目录、灵活配置与高性能直接响应。
Spring Boot 通过配置外部化存储来托管静态资源，核心是把文件存到项目外的磁盘路径，并让 Web 层能直接通过 HTTP 访问这些文件，而不是只依赖 classpath 下的 static 或 public 目录。这种方式适合需要动态上传、独立管理图片、附件等场景。
配置外部目录映射为静态资源路径
最常用且推荐的方式是实现 WebMvcConfigurer 接口，重写 addResourceHandlers 方法：
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
@Value("${server.image-resource:/opt/app/images/}")
private String imagePath;
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
File dir = new File(imagePath);
if (!dir.exists()) {
dir.mkdirs(); // 自动创建目录，避免启动失败
}
registry.addResourceHandler("/images/**")
.addResourceLocations("file:" + imagePath + "/");
}
}说明：
-
@Value从application.yml或application.properties注入路径，支持默认值（如/opt/app/images/） -
file:前缀表示访问本地文件系统，不是 classpath -
/images/**是浏览器可访问的虚拟路径，比如请求http://localhost:8080/images/logo.png就会映射到imagePath/logo.png -
mkdirs()确保目录存在，否则首次访问可能 404 或抛异常
在配置文件中定义路径（application.yml）
server: image-resource: /data/static/images
或 Windows 下：
立即学习“Java免费学习笔记（深入）”；
server: image-resource: D:/app/static/images
⚠️ 注意：路径末尾建议不加斜杠（代码里已补），避免重复 / 导致路径错误。
替代方案：用 spring.web.resources.static-locations（仅限 classpath 或 file:）
该配置项也支持 file: 协议，但有重要限制：
spring:
web:
resources:
static-locations: file:/data/static/images/, classpath:/static/- ✅ 支持多个位置，用逗号分隔
- ❌ 一旦配置，Spring Boot 默认的四个 classpath 路径（
/static,/public等）全部失效，只认你写的路径 - ⚠️
file:路径必须存在，否则启动报错（不像WebMvcConfigurer可主动创建）
所以更灵活、更安全的做法仍是自定义 addResourceHandlers。
文件上传后如何生成可访问 URL？
假设用户上传一张图，保存到 /data/static/images/avatar_1001.jpg，那么返回给前端的 URL 就是：
/images/avatar_1001.jpg
因为 addResourceHandler("/images/**") 已将该前缀绑定到外部目录。
不需要 Controller 转发，不走业务逻辑，直接由 Spring MVC 的资源处理器响应，性能好、无侵入。
补充：权限与安全性提醒
- 外部目录不要放在敏感路径（如
/root、用户主目录），推荐统一规划如/data/static/ - 生产环境建议配合 Nginx 做静态资源代理（提升并发、缓存、HTTPS 卸载），此时 Spring Boot 只负责业务，不暴露文件系统路径
- 若必须由 Spring Boot 直接提供，可在
addResourceHandler中设置缓存策略：
registry.addResourceHandler("/images/**")
.addResourceLocations("file:" + imagePath + "/")
.setCachePeriod(3600)
.resourceChain(true);不复杂但容易忽略
