Docker Compose配置共享卷提示引用未定义volume问题排查

直接导致启动报错的配置错误 #

你在web和celery服务的卷挂载规则中，给命名卷名末尾多加了一个斜杠：

volumes:
  - "shared_web_volume/:/MoreEnergy/"

Docker Compose对命名卷的名称匹配是严格精确的，你在顶层volumes块声明的卷名是shared_web_volume，但挂载时写的shared_web_volume/多了尾部斜杠，Compose会判定这是一个未被定义的卷，因此抛出undefined volume的启动错误。

把两个服务下的这行配置去掉卷名后的斜杠，改成- "shared_web_volume:/MoreEnergy/"即可解决这个语法层面的启动报错。

现有共享文件方案的缺陷与优化建议 #

你将整个项目根目录挂载到命名卷、同时把FILE_UPLOAD_TEMP_DIR设为项目目录的思路存在明显隐患：

• 命名卷首次挂载到容器路径时，会自动将容器内该路径的初始文件拷贝到卷中，但后续你重新构建镜像更新项目代码时，卷内存储的旧代码不会被新镜像内容覆盖，会导致web和celery运行的代码与你最新构建的版本不一致，引发难以排查的运行异常。
• 推荐单独使用命名卷仅挂载临时上传文件的专属目录，不要挂载整个项目根目录，修正后的核心配置参考如下：

volumes:
  shared_tmp_upload: # 临时上传文件专用共享卷
  postgres_data:

services:
  db:
    image: postgres:12.0-alpine
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    env_file:
      - ./.env
  web:
    build:
      context: ./MoreEnergy
      dockerfile: Dockerfile
    entrypoint: sh ./entrypoint.sh
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      # 仅挂载临时文件目录，不挂载整个项目根目录
      - "shared_tmp_upload:/MoreEnergy/tmp_uploads"
    ports:
      - 1337:8000
    env_file:
      - ./.env
    depends_on:
      - db
  celery:
    build:
      context: ./MoreEnergy
      dockerfile: Dockerfile
    entrypoint: sh ./entrypoint.sh
    command: celery  -A MoreEnergy worker --loglevel=info
    volumes:
      # 和web服务挂载同一个卷到相同容器路径，保证文件可共享访问
      - "shared_tmp_upload:/MoreEnergy/tmp_uploads"
    env_file:
      - ./.env
    depends_on:
      - web
      - redis
  redis:
    image: redis:5-alpine

对应Django settings中把FILE_UPLOAD_TEMP_DIR配置为/MoreEnergy/tmp_uploads即可，既满足两个服务共享临时上传文件的需求，也不会干扰镜像内项目代码的正常更新。

另外需要注意两个使用细节：

• 要保证web和celery服务中挂载的容器内路径完全一致，否则同一份文件在两个服务中的路径不同会导致读取失败。
• TemporaryUploadedFile默认会在当前请求处理完成后自动删除，如果需要交给Celery异步任务处理上传文件，必须在推送异步任务前将临时文件转存到持久化路径，否则请求结束后文件被自动清理，Celery任务会出现文件不存在的错误。

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