Quarkus部署后无法提供上传静态图片服务问题求助

核心问题 #

本地开发模式下Quarkus会热加载静态资源目录的新增文件，但生产部署（Docker运行）后，Quarkus默认不会动态扫描META-INF/resources的新增内容，同时挂载卷权限、静态资源配置与生产环境要求不匹配，导致图片无法访问。

解决方案 #

1. 调整静态资源存储路径与Quarkus配置 #

放弃将图片存入src/main/resources/META-INF/resources（该目录在生产打包后属于jar包内部，无法动态加载新增文件），改为使用外部挂载目录作为静态资源存储：

• 修改application.properties，添加外部静态资源配置：

  quarkus.http.root-path=/api
  # 配置静态资源访问路径前缀（与API路径对齐）
  quarkus.http.static-resources.paths=/
  # 指定容器内外部静态资源目录
  quarkus.http.static-resources.locations=file:/opt/app/static-resources/
  # 关闭目录列表（按需开启）
  quarkus.http.static-resources.directory-listing.enabled=false
  

• 调整图片上传逻辑，将文件写入容器内的/opt/app/static-resources/目录，同时在Docker Compose中挂载该目录到宿主机：

  backend:
    volumes:
      - ./static-resources:/opt/app/static-resources/
  

2. 修复Docker挂载目录权限 #

确保容器内Quarkus运行用户（默认UID=1000）对挂载目录有读写权限：

• 宿主机端执行：

  mkdir -p ./static-resources
  chown -R 1000:1000 ./static-resources
  

• 或在Dockerfile中提前配置权限：

  RUN mkdir -p /opt/app/static-resources && chown -R 1000:1000 /opt/app/static-resources
  

3. 修正Traefik配置 #

首先修正标签拼写错误（treafik应为traefik），再确保路由规则正确转发所有/api前缀请求：

backend:
  labels:
    "traefik.http.routers.server.entrypoints": "websecure"
    "traefik.http.routers.server.rule": "Host(`domain.de`) && PathPrefix(`/api`)"
    # 若Quarkus已配置root-path=/api，无需剥离前缀；否则添加以下中间件
    # "traefik.http.middlewares.server-stripprefix.stripprefix.prefixes": "/api"
    # "traefik.http.routers.server.middlewares": "server-stripprefix@docker"

4. 验证排查步骤 #

• 进入容器检查图片是否存在于/opt/app/static-resources/目录：

  docker exec -it <backend-container-id> ls /opt/app/static-resources/
  

• 容器内测试访问：

  docker exec -it <backend-container-id> curl http://localhost:8080/api/image-123.png
  

  容器内访问正常则问题出在Traefik转发或外部网络；容器内也无法访问则检查Quarkus配置与文件权限。

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