Docker部署Spring Boot应用：图片上传成功却无法显示的问题排查

核心原因 #

Spring Boot默认不会将容器内的/uploads目录识别为静态资源路径，因此即使文件已成功上传，网页请求也无法获取到对应资源。以下是具体修复步骤：

1. 配置Spring Boot静态资源映射 #

创建Web配置类，将容器内的/uploads目录映射为可通过HTTP访问的静态资源路径：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 将本地文件系统的/uploads目录映射到请求路径/uploads/**
        registry.addResourceHandler("/uploads/**")
                .addResourceLocations("file:/uploads/");
    }
}

这段代码告诉Spring Boot：当收到以/uploads/开头的请求时，直接去容器内的/uploads目录查找对应文件。

2. 确保容器内目录权限正确 #

Docker容器内的/uploads目录可能存在权限问题，导致Spring Boot进程无法读取文件，可通过两种方式修复：

• 在Dockerfile中预设目录权限：

  RUN mkdir -p /uploads && chmod 755 /uploads
  

• 在docker-compose.yml中指定运行用户：
  在app服务节点下添加：

  user: "root"
  

  （或使用拥有/uploads目录读写权限的非root用户）

3. 验证请求URL与端口映射 #

• 确认docker-compose.yml中的ports映射与网页中使用的端口一致，比如.env文件中SPRING_LOCAL_PORT=8081，则请求URL的端口必须为8081。
• 如果是在非本机访问Docker应用，需将127.0.0.1替换为Docker主机的实际IP地址。

4. 验证资源访问有效性 #

使用curl命令测试图片是否能正常获取：

curl http://127.0.0.1:8081/uploads/product/6/Screenshot_1.png

• 返回图片二进制内容：说明配置生效；
• 返回404：检查静态资源映射配置是否正确；
• 返回权限错误：检查目录权限设置是否到位。

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