Docker容器内Cron无法继承环境变量的问题排查与解决

问题 #

我尝试在Docker容器中运行Cron，定期执行数据库更新、备份等任务，配置的Cron任务如下：

*/1 * * * * (. /app/.env.development; echo $DJANGO_COLOR) >> /var/log/cron.log 2>&1
*/1 * * * * (. /app/.env.development; /usr/local/bin/python3 /app/src/manage.py command) >> /var/log/cron.log 2>&1
*/1 * * * * (export $(cat /app/.env.development | grep -v "^#" | xargs); /usr/local/bin/python3 /app/src/manage.py command) >> /var/log/cron.log 2>&1

遇到的问题：Cron任务无法继承Docker容器的环境变量。通过. /app/.env.development加载环境变量时，第一条任务能正常输出变量，但第二、三条执行Django的manage.py命令时，环境变量并未生效。

对应的Cron Dockerfile如下：

FROM app as cron

RUN apt-get update && apt-get -y install cron

# Copy hello-cron file to the cron.d directory
COPY cron/app-cron /etc/cron.d/app-cron

# Give execution rights on the cron job
RUN chmod 0644 /etc/cron.d/app-cron

# Apply cron job
RUN crontab /etc/cron.d/app-cron

# Create the log file to be able to run tail
RUN touch /var/log/cron.log

Entrypoint配置为：/bin/bash -c "cron && tail -f /var/log/cron.log"

原因分析 #

1. Cron执行环境的特殊性：Cron启动的任务会使用极简的默认环境（PATH等核心变量都被限制），不会继承Docker容器中bash会话的环境变量，哪怕在Entrypoint里启动cron也无法改变这一点。
2. 环境变量加载的上下文问题：第一条任务的echo $DJANGO_COLOR和加载.env的操作在同一个子shell中，所以能拿到变量；但Django的manage.py执行时，可能因为子shell环境传递不完整，或者.env文件的变量格式（比如含空格、特殊字符）导致加载失败，使得Python进程没拿到正确的环境变量。
3. export $(cat ...)的局限性：这种方式如果.env里的变量值包含空格、引号或特殊字符，会被xargs错误拆分，导致变量无法正确导出。

解决方法 #

方法一：指定bash执行并正确加载.env #

修改Cron任务，用bash执行整个命令，并用单引号包裹避免Cron提前解析变量：

*/1 * * * * /bin/bash -c 'source /app/.env.development && /usr/local/bin/python3 /app/src/manage.py command' >> /var/log/cron.log 2>&1

source和.等价，用bash执行能保证shell的环境加载逻辑正常，单引号包裹可以避免Cron把$DJANGO_COLOR这类变量提前解析。

方法二：将.env变量写入Cron全局环境配置 #

Cron会读取/etc/environment的环境变量配置，在Dockerfile中添加步骤把.env变量导入该文件：

# 将.env变量导入Cron全局环境配置（需确保.env已在容器内）
RUN grep -v "^#" /app/.env.development >> /etc/environment

这样所有Cron任务都会自动继承这些环境变量，无需在每个任务里手动加载.env。如果base镜像app里没有.env.development，需要先复制文件：COPY .env.development /app/。

方法三：封装统一的环境加载脚本 #

创建run_cron_task.sh脚本：

#!/bin/bash
source /app/.env.development
exec "$@"

给脚本添加执行权限：

chmod +x run_cron_task.sh

然后修改Cron任务：

*/1 * * * * /app/run_cron_task.sh /usr/local/bin/python3 /app/src/manage.py command >> /var/log/cron.log 2>&1

所有Cron任务通过这个脚本启动，确保环境变量被正确加载。

额外注意事项 #

• 检查.env.development格式：变量值带空格时要加引号，比如DJANGO_COLOR="light blue"，避免加载出错。
• 确认Cron任务的用户权限：如果manage.py需要特定用户执行，要在/etc/cron.d/app-cron开头指定用户（比如ROOT或对应用户名）。
• 测试环境变量：可以在任务中添加env >> /var/log/cron_env.log，查看Cron任务的实际环境变量，方便定位问题。

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