SpringSecurity-Demo 配置外部文件映射一、需求说明二、实现步骤1. 定义配置属性类读取yml配置2. 编写资源映射配置3. application.yml 配置路径可自定义三、原理讲解一看就懂四、使用示例五、路径写法说明1. 相对路径2. Windows 绝对路径3. Linux 绝对路径六、常见问题1. 访问4042. 不想用profile作为URL前缀3. 映射网络路径在 Spring Boot 项目开发中我们经常需要上传图片、文档等文件并希望通过浏览器地址直接访问比如头像、附件预览。但直接把文件存在项目内部会导致打包过大、更新不便所以最佳实践是文件存在外部文件夹通过 Spring MVC 资源映射实现外网访问。本篇博客就带你一步步实现外部文件目录 → 浏览器在线访问完全适配 Spring Boot 3.2.4 JDK 21代码可直接复制用于生产环境。一、需求说明我们要实现的功能非常简单实用把文件存在项目根目录的./file文件夹实际使用可配置其它目录通过地址http://localhost:5826/profile/xxx.png直接访问图片路径可配置不写死代码二、实现步骤代码已推送至 Gitee 仓库springdecurity-demo1. 定义配置属性类读取yml配置专门用来读取外部配置代码解耦、规范优雅。packagecom.junjiu.springboot3.config.properties;importlombok.Data;importorg.springframework.boot.context.properties.ConfigurationProperties;importorg.springframework.stereotype.Component;/** * program: security-demo * ClassName: JunjiuCustomProperties * description: * * author: 君九 * create: 2026-04-03 14:35 * version: 1.0 **/DataComponentConfigurationProperties(prefixjunjiu.custom)publicclassJunjiuCustomProperties{/** * 外部资源存储路径 * 例如./file */privateStringresourcePath;}2. 编写资源映射配置继承WebMvcConfigurer重写addResourceHandlers实现外部文件夹映射到URL。packagecom.junjiu.springboot3.config;importcom.junjiu.springboot3.config.properties.JunjiuCustomProperties;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.context.annotation.Configuration;importorg.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;importorg.springframework.web.servlet.config.annotation.WebMvcConfigurer;/** * 外部资源映射配置 * 实现外部文件夹 - 浏览器URL访问 */ConfigurationpublicclassResourceConfigimplementsWebMvcConfigurer{AutowiredprivateJunjiuCustomPropertiesjunjiuCustomProperties;OverridepublicvoidaddResourceHandlers(ResourceHandlerRegistryregistry){// 从配置文件读取路径StringresourcePathjunjiuCustomProperties.getResourcePath();// 确保路径以 / 结尾避免拼接错误if(!resourcePath.endsWith(/)){resourcePath/;}System.out.println(外部资源路径resourcePath);// 映射规则// 浏览器访问 /profile/** → 找本地 file:xxx 目录registry.addResourceHandler(/profile/**).addResourceLocations(file:resourcePath);}}3. application.yml 配置路径可自定义junjiu:custom:resource-path:./file# 相对路径项目根目录下的 file 文件夹三、原理讲解一看就懂registry.addResourceHandler(/profile/**).addResourceLocations(file:resourcePath);作用当你访问http://localhost:5826/profile/avatar.jpgSpring Boot 就会去项目根目录/file/avatar.jpg找图片找到就直接显示找不到返回404✅ 支持图片png/jpg/gif文档pdf/txt视频mp4音频mp3四、使用示例在项目根目录创建file文件夹放入一张图片xr.jpg启动项目浏览器访问http://localhost:5826/profile/xr.jpg✅ 直接显示图片五、路径写法说明1. 相对路径resource-path:./file表示项目根目录/file2. Windows 绝对路径resource-path:D:/upload/file3. Linux 绝对路径resource-path:/home/server/upload六、常见问题1. 访问404检查文件夹是否创建检查文件名大小写检查路径是否以/结尾重启项目2. 不想用profile作为URL前缀修改这里即可addResourceHandler(/files/**)访问地址变成http://localhost:5826/files/test.jpg3. 映射网络路径支持但需要权限和共享目录。代码已推送至 Gitee 仓库springdecurity-demo若有转载请标明出处