Spring Boot如何加载项目外部目录中的图片

1. 修正图片路径存储逻辑 #

你现在user.setPicture()存的是物理磁盘路径（比如/var/webapp/images/1/avatar.jpg），浏览器根本无法直接访问服务器磁盘上的绝对路径，必须改成服务器暴露的URL路径。

修改saveImage方法中的路径设置：

// 定义外部图片的URL前缀，后续会映射到物理目录
private String EXTERNAL_IMAGE_URL_PREFIX = "/external-images/";
private String IMAGES_ROOT = "/var/webapp/images/";

public void saveImage(MultipartFile image) throws IOException {
    String currentUsername = SecurityUtil.getSessionUser();
    UserEntity user = userRepository.findByName(currentUsername);
    if (!image.isEmpty()) {
        if (user.getPicture() != null) {
            // 把URL路径转成物理路径再删除
            String oldPhysicalPath = user.getPicture().replace(EXTERNAL_IMAGE_URL_PREFIX, IMAGES_ROOT);
            Files.deleteIfExists(Paths.get(oldPhysicalPath));
        }
        Path imageDir = Paths.get(IMAGES_ROOT + user.getId().toString());
        if (!Files.exists(imageDir)) {
            Files.createDirectories(imageDir);
        }
        String fileName = image.getOriginalFilename();
        // 存储URL路径，而非物理路径
        String imageUrl = EXTERNAL_IMAGE_URL_PREFIX + user.getId() + "/" + fileName;
        user.setPicture(imageUrl);
        // 物理路径用于保存文件
        Path physicalPath = imageDir.resolve(fileName);
        Files.copy(image.getInputStream(), physicalPath);
        userRepository.save(user);
    }
}

2. 配置WebMvc资源映射（同时支持内部+外部静态资源） #

创建WebMvcConfig类，实现WebMvcConfigurer，添加资源处理器，把外部物理目录映射到刚才定义的URL前缀，同时保留Spring Boot默认的内部静态资源（resources/static/）访问：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    // 外部图片物理路径，可配置到application.properties中更灵活
    @Value("${app.external.image.path:/var/webapp/images/}")
    private String externalImagePath;

    // 外部图片URL前缀
    private String externalImageUrlPrefix = "/external-images/";

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射外部图片目录到URL路径
        registry.addResourceHandler(externalImageUrlPrefix + "**")
                .addResourceLocations("file:" + externalImagePath);
        
        // 保留默认的内部静态资源映射（resources/static/下的css、js、images等）
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:/static/");
    }
}

如果需要支持Windows路径（比如D:/var/webapp/images/），直接修改app.external.image.path配置即可，file:前缀会自动适配不同系统的路径格式。

3. 更新Spring Security配置，允许访问外部资源路径 #

在你的Security配置中，新增/external-images/**到允许匿名访问的列表：

http.authorizeHttpRequests(auth -> {
    auth.requestMatchers("/login", "/register", "/css/**", "/js/**", "/images/**", "/external-images/**").permitAll();
    // 其他权限配置...
})

4. 前端Thymeleaf无需修改 #

现在user.picture存储的是合法的URL路径（比如/external-images/1/avatar.jpg），Thymeleaf的<img th:src="${user.picture}">会直接生成正确的图片请求，服务器会通过资源映射找到对应的物理文件。

• 为什么之前用spring.resources.static-locations不行？因为这个配置会覆盖默认的静态资源路径，如果只配置外部目录，内部的static/images就访问不到了；如果同时配置多个位置，Spring Boot会按顺序查找，但你之前的路径存储逻辑用的是物理路径，依然无法被浏览器访问。
• 必须区分物理存储路径和URL访问路径：物理路径是服务器磁盘上的位置，仅后端使用；URL路径是暴露给前端的访问地址，通过资源映射关联到物理路径。

内容的提问来源于stack exchange，提问作者David