Spring MVC+Thymeleaf图片上传显示异常问题求助

看起来你遇到的核心问题是上传图片的存储路径配置不合理，再加上Spring MVC默认的静态资源映射规则限制，导致Thymeleaf无法正确加载你上传的图片，反而显示了静态资源目录里的旧图片。下面是一步步的解决方法：

1. 更换图片存储目录（关键！） #

别再把上传的图片存在src/main/resources/images里了——这个目录属于源码目录，编译后会被打包到classpath（比如jar包内部），运行时上传的动态文件无法自动同步到这里，而且项目打包成jar后，根本没法往jar内部写入文件。

建议换成一个独立于项目源码的外部目录，比如：

// 控制器里修改存储路径
File imageDir = new File("C:/Users/lukas/uploadedImages/");
// 确保目录不存在时自动创建
if (!imageDir.exists()) {
    imageDir.mkdirs();
}

2. 配置Spring MVC静态资源映射 #

让Spring MVC能识别这个外部目录的图片，创建一个Web配置类：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射URL路径 /images/** 到外部存储目录
        registry.addResourceHandler("/images/**")
                .addResourceLocations("file:C:/Users/lukas/uploadedImages/");
    }
}

这个配置的意思是：当前端请求/images/xxx.jpg时，Spring会去C:/Users/lukas/uploadedImages/目录下找对应的文件。

3. 调整控制器传递给Thymeleaf的路径 #

确保你传递给页面的path变量是正确的URL路径，而不是本地文件路径。比如上传完成后，控制器里设置：

// 假设fileName是上传后的文件名，比如"0.jpg"
String path = "/images/" + fileName;
model.addAttribute("path", path);

4. 验证页面路径正确性 #

检查showimage.html里的<p th:text="${path}">显示的内容是不是/images/0.jpg（必须是正斜杠，不能用反斜杠）。URL路径里的反斜杠会导致解析错误，这也是常见的坑。

为什么原来的方式不行？ #

• src/main/resources/images不在Spring MVC默认的静态资源映射范围内，默认只映射classpath:/static/、classpath:/public/等目录，所以即使你把图片存在这里，前端也访问不到。
• 你看到的“其他文件夹的图片”应该是static/images目录下的同名文件——Spring会优先加载默认静态资源目录里的内容。
• 运行时上传到源码目录的文件，不会自动被IDE或Spring的类加载器识别，除非手动刷新，但这在生产环境完全不可行。

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