Java Spring项目如何显示根目录外文件及解决新增图片不生效问题

1. 修正资源处理器的文件路径 #

你当前资源处理器里用的相对路径file:anination07/uploads/存在路径指向风险——这个路径是相对于应用启动的工作目录，而非项目根目录。建议改为动态获取项目根目录的绝对路径，避免路径偏移：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/static/**")
            .addResourceLocations("classpath:/static/")
            .setCacheControl(CacheControl.noStore());
    // 动态获取项目根目录下的uploads绝对路径
    String absoluteUploadPath = new File(System.getProperty("user.dir"), "uploads").getAbsolutePath() + File.separator;
    registry.addResourceHandler("/uploads/**")
            .addResourceLocations("file:" + absoluteUploadPath)
            .setCacheControl(CacheControl.noStore());
}

也可以先直接写死绝对路径（比如file:/home/xxx/projects/anination07/uploads/）测试，确认路径指向正确。

2. 确保HTML图片引用路径正确 #

页面中引用uploads文件夹内的图片，必须使用/uploads/[图片文件名]的格式，例如：

<img src="/uploads/your-image.png" alt="图片描述">

禁止使用相对路径（如../uploads/xxx.png）或错误前缀。

3. 排除缓存与文件权限问题 #

• 按Ctrl+Shift+R强制刷新浏览器，或用无痕模式访问，排除浏览器缓存干扰；
• 检查uploads文件夹及内部图片的读取权限：
  • Linux/macOS执行命令：chmod -R 755 ./uploads/
  • Windows右键文件夹→属性→确认"读取"权限已为应用进程开启。

4. 验证资源映射是否生效 #

启动应用后，查看日志是否有类似以下输出，确认/uploads/**的资源映射已被正确加载：

Mapped URL path [/uploads/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]

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