Gin后端Docker部署后图片上传成功但GET请求返回404求助

1. 确认文件实际写入路径是否匹配 #

• 直接登录云服务器，查看你映射的主机目录（比如/data/gin-static）下是否存在刚上传的图片。若不存在，说明文件未正确写入宿主机：
  • 检查Gin代码中的上传保存路径，避免使用相对路径（如./static/uploads），改用容器内绝对路径（比如/app/static/uploads）；同时确认Dockerfile中是否通过WORKDIR指定了正确的工作目录。
  • 核对容器启动命令的-v参数格式，必须是宿主机绝对路径:容器内绝对路径，例如docker run -v /data/gin-static:/app/static/uploads your-image，不要颠倒顺序。

2. 检查Gin静态资源路由配置 #

• 确认Gin代码中已正确注册静态资源路由，确保路由前缀与前端请求URL一致：

  // 推荐使用绝对路径注册
  r.StaticFS("/uploads", http.Dir("/app/static/uploads"))
  

  比如前端请求http://your-server/uploads/xxx.jpg，则路由前缀必须是/uploads，且对应容器内的路径要和映射路径完全匹配。

3. 排查文件与目录权限问题 #

• 检查宿主机映射目录的权限，赋予可读可访问权限：

  chmod -R 755 /data/gin-static
  

  若Docker容器以非root用户运行（比如Dockerfile中创建了专用用户），需确保该用户对容器内静态目录拥有读写权限：

  RUN useradd -m appuser
  USER appuser
  

4. 验证反向代理（如Nginx）配置 #

• 如果前端通过Nginx代理静态资源请求，需确保Nginx配置直接指向宿主机的静态目录，而非容器内路径：

  location /uploads {
      root /data/gin-static;
      expires 30d;
  }
  

  若前端也使用Docker部署，需给Nginx容器同样添加-v参数映射宿主机静态目录。

5. 检查缓存与大小写问题 #

• 清理浏览器缓存后重新测试，避免本地缓存导致的404；同时注意Linux系统大小写敏感，确认上传文件名与请求文件名的大小写完全一致。

6. 容器内部连通性测试 #

• 进入容器内部，用curl验证静态资源是否可访问：

  docker exec -it your-container-id curl http://localhost/uploads/xxx.jpg
  

  若容器内访问正常，问题大概率出在宿主机端口映射或外部网络路由；若容器内也返回404，需重新检查Gin路由或文件写入逻辑。

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