Spring Boot 默认静态资源路径无法访问上传文件，因其仅扫描classpath下的/static、/public等路径，而上传文件存于磁盘目录（如/data/uploads/），需通过WebMvcConfigurer显式注册file:开头的外部路径映射，并确保URL模式含/**、目录存在且有读权限。
Spring Boot 默认静态资源路径为什么访问不到上传的文件
默认情况下，spring.resources.static-locations 只指向 classpath:/static/、classpath:/public/ 等 classpath 路径，而你上传的文件通常落在磁盘上的某个目录（比如 /data/uploads/），不在 classpath 里，自然 404。
这不是配置没生效，是根本没被 Spring MVC 的资源处理器扫描到。
- 上传目录必须显式注册为静态资源位置，不能只靠默认值
- 路径需以
/开头（如/uploads/**），否则匹配规则失效 - 注册顺序有影响：自定义路径应优先于默认路径，避免被后者拦截
如何用 WebMvcConfigurer 添加外部上传目录映射
重写 addResourceHandlers 是最直接的方式，把磁盘目录挂载成 HTTP 可访问路径。关键不是“加一个 handler”，而是确保它能正确解析请求路径并定位到真实文件。
示例配置（Java Config）：
立即学习“Java免费学习笔记（深入）”；
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/uploads/**")
.addResourceLocations("file:/data/uploads/");
}
}
-
addResourceHandler中的路径是 URL 模式，必须带/**，否则无法匹配子路径 -
addResourceLocations的值必须以file:开头，Windows 下写成file:C:/data/uploads/ - 如果目录不存在，启动时不会报错，但访问时返回 404 —— 建议在应用启动时用
Files.exists()检查 - 注意权限：Spring Boot 进程需对目标目录有读取权限，Linux 下尤其容易因用户权限漏掉
上传文件后怎么生成可访问的 URL
上传逻辑和静态映射是两件事。你得自己保存文件到 /data/uploads/，再拼出对应 URL，而不是依赖框架自动处理。
- 上传接口中，用
transferTo(new File("/data/uploads/" + filename))写入磁盘 - 返回前端的 URL 应为
http://host:port/uploads/filename.jpg，不是本地路径 - 不要硬编码 host/port，用
HttpServletRequest.getRequestURL()或配置项动态构造 - 文件名务必过滤或重命名，避免路径遍历（如
../../etc/passwd）—— 即使映射路径固定，transferTo仍可能被绕过
为什么浏览器能打开图片却下载不了 PDF 或 ZIP
这不是映射问题，是 MIME 类型缺失导致浏览器无法识别内容类型，默认触发下载行为。
- Spring Boot 2.3+ 默认只对常见扩展名（jpg、png、css、js 等）设置
Content-Type，PDF、ZIP、SVG 等常被当成application/octet-stream - 解决方法是在
application.properties中补充：spring.http.log-request-details=true仅用于调试；真正有效的是加spring.web.resources.chain.strategy.content.enabled=true并配合自定义ResourceHttpRequestHandler - 更稳妥的做法：在 Controller 中手动设置响应头，或改用
ResponseEntity<resource></resource>返回，并调用resource.getFilename()触发自动推断
