Dockerfile执行Django collectstatic无法读取.env，如何自动执行？

问题原因 #

Dockerfile中的RUN命令属于镜像构建阶段，而docker-compose里env_file声明的环境变量是在容器启动阶段才加载的。构建镜像时根本拿不到这些变量，所以执行collectstatic会失败；手动进入容器执行时，容器已经启动，环境变量已加载，所以能正常运行。

解决方案 #

方案一：直接修改docker-compose的command命令

把web服务的command改成先执行静态文件收集，再启动服务：

web:
  # 其他配置不变
  command: bash -c "python manage.py collectstatic --noinput && python manage.py runserver 0.0.0.0:8000"

添加--noinput参数是为了跳过交互式确认，确保命令能自动执行。

方案二：使用启动脚本

1. 在项目根目录创建start.sh脚本，内容如下：

#!/bin/bash
# 执行静态文件收集
python manage.py collectstatic --noinput
# 启动Django服务
python manage.py runserver 0.0.0.0:8000

2. 给脚本添加执行权限：

chmod +x start.sh

3. 修改docker-compose中web服务的command：

web:
  # 其他配置不变
  command: ./start.sh

方案三：构建阶段传递环境变量（不推荐）

如果一定要在镜像构建阶段执行collectstatic，可以通过构建参数传递环境变量，但这种方式会把敏感变量打包进镜像，存在安全风险，仅适合非敏感场景：

1. 修改docker-compose的web服务build配置，添加构建参数：

web:
  build:
    context: .
    dockerfile: Dockerfiles/app/Dockerfile
    args:
      - DJANGO_SECRET_KEY=${DJANGO_SECRET_KEY}
      - DJANGO_SETTINGS_MODULE=${DJANGO_SETTINGS_MODULE}
      # 按需添加其他需要的环境变量
  # 其他配置不变

2. 修改Dockerfile，接收构建参数并转为环境变量：

# 接收构建参数
ARG DJANGO_SECRET_KEY
ARG DJANGO_SETTINGS_MODULE

# 转为环境变量
ENV DJANGO_SECRET_KEY=$DJANGO_SECRET_KEY
ENV DJANGO_SETTINGS_MODULE=$DJANGO_SETTINGS_MODULE

# 执行静态文件收集
RUN python manage.py collectstatic --noinput

内容的提问来源于stack exchange，提问作者Zbyszek Kisły