Docker环境变量无法写入/root/.profile问题的解决方法

Docker构建阶段和容器运行阶段完全分离：docker-compose.yml里的env_file仅在容器启动时加载环境变量，而Dockerfile中的RUN指令是在镜像构建阶段执行的，此时这些变量尚未存在，因此写入/root/.profile的值为空。

方案1：构建阶段传入环境变量（适合需固化变量到镜像的场景） #

通过docker-compose的构建参数将环境变量传递到构建阶段，再写入/root/.profile：

1. 修改docker-compose.yml的build块，添加args传递变量：

services:
  django:
    build:
      context: .
      dockerfile: ./compose/local/django/Dockerfile
      args:
        - SENDGRID_KEY=${SENDGRID_KEY}
        - SENDGRID_FROM=${SENDGRID_FROM}
        - POSTGRES_HOST=${POSTGRES_HOST}
        - POSTGRES_PORT=${POSTGRES_PORT}
        - POSTGRES_DB=${POSTGRES_DB}
        - POSTGRES_USER=${POSTGRES_USER}
        - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    # 其他配置保持不变

2. 修改Dockerfile，先声明参数再写入/root/.profile（合并多个RUN减少镜像层）：

# 声明构建参数
ARG SENDGRID_KEY
ARG SENDGRID_FROM
ARG POSTGRES_HOST
ARG POSTGRES_PORT
ARG POSTGRES_DB
ARG POSTGRES_USER
ARG POSTGRES_PASSWORD

# 写入环境变量到.profile
RUN echo "SENDGRID_KEY=${SENDGRID_KEY}; export SENDGRID_KEY" >> /root/.profile && \
    echo "SENDGRID_FROM=${SENDGRID_FROM}; export SENDGRID_FROM" >> /root/.profile && \
    echo "POSTGRES_HOST=${POSTGRES_HOST}; export POSTGRES_HOST" >> /root/.profile && \
    echo "POSTGRES_PORT=${POSTGRES_PORT}; export POSTGRES_PORT" >> /root/.profile && \
    echo "POSTGRES_DB=${POSTGRES_DB}; export POSTGRES_DB" >> /root/.profile && \
    echo "POSTGRES_USER=${POSTGRES_USER}; export POSTGRES_USER" >> /root/.profile && \
    echo "POSTGRES_PASSWORD=${POSTGRES_PASSWORD}; export POSTGRES_PASSWORD" >> /root/.profile

方案2：运行阶段动态生成.profile（适合本地开发场景） #

将写入/root/.profile的操作放到容器启动脚本（比如/start）中，启动时已加载env_file的变量，能拿到正确值：

修改/start脚本，在启动主命令前添加以下内容：

# 清空旧的变量配置（避免重复写入）
> /root/.profile

# 写入环境变量
echo "SENDGRID_KEY=${SENDGRID_KEY}; export SENDGRID_KEY" >> /root/.profile
echo "SENDGRID_FROM=${SENDGRID_FROM}; export SENDGRID_FROM" >> /root/.profile
echo "POSTGRES_HOST=${POSTGRES_HOST}; export POSTGRES_HOST" >> /root/.profile
echo "POSTGRES_PORT=${POSTGRES_PORT}; export POSTGRES_PORT" >> /root/.profile
echo "POSTGRES_DB=${POSTGRES_DB}; export POSTGRES_DB" >> /root/.profile
echo "POSTGRES_USER=${POSTGRES_USER}; export POSTGRES_USER" >> /root/.profile
echo "POSTGRES_PASSWORD=${POSTGRES_PASSWORD}; export POSTGRES_PASSWORD" >> /root/.profile

# 执行原启动命令（替换为你的实际启动命令）
exec gunicorn sindgestor.wsgi:application --bind 0.0.0.0:8000

方案3：直接让cron加载env文件（最简洁，无需修改Dockerfile/启动脚本） #

不需要写入/root/.profile，直接在cron任务中加载env_file，让Python脚本获取变量：

修改cron配置为：

0 6 1 * * /bin/bash -c 'set -a; source ./.envs/.local/.django; source ./.envs/.local/.postgres; source ./.envs/.local/.sendgrid; python /app/backend/trigger_schedule.py MORNING MONTHLY'

• set -a：自动导出后续加载的环境变量，确保Python脚本能读取到
• 直接加载所有需要的env文件，跳过/root/.profile的中间环节

• 生产环境若需将变量固化到镜像，选方案1（注意敏感变量不要通过镜像泄露）
• 本地开发优先选方案2或3，操作更灵活，避免镜像包含敏感信息

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