Docker Compose中Django Crontab定时任务未执行及环境变量问题

问题现象 #

手动执行python manage.py crontab run some-hash时任务正常运行，但自动定时执行从未生效。已确认：

• cron服务已启动
• 任务通过crontab -l显示已成功添加
• Dockerfile已安装cron，django_crontab已加入INSTALLED_APPS
• 日志捕获到错误：执行任务时无法读取.env文件中的SECRET_KEY等环境变量

解决方案 #

方法1：给Cron任务添加环境变量加载前缀 #

修改settings.py中的CRONTAB_COMMAND_PREFIX，让每个定时任务执行前先加载.env文件：

# settings.py
CRONTAB_COMMAND_PREFIX = 'source /code/.env &&'

注意：容器内.env文件的路径需与实际挂载路径一致（此处因Compose挂载了./:/code，所以路径为/code/.env）。

方法2：将环境变量写入Cron的全局配置 #

在启动cron服务前，把.env中的变量导入到Cron会读取的全局环境文件中，修改Compose的command命令：

# docker-compose.yml
command: bash -c "cat /code/.env >> /etc/environment && service cron start && python manage.py crontab add && crontab -l && gunicorn -w 2 -b 0.0.0.0:8000 project.wsgi:application"

或者通过export临时注入环境变量（重启容器后失效）：

command: bash -c "export $(cat /code/.env | xargs) && service cron start && python manage.py crontab add && crontab -l && gunicorn -w 2 -b 0.0.0.0:8000 project.wsgi:application"

注意：.env文件需为标准的KEY=VALUE格式，避免多余引号或注释干扰。

方法3：让Django直接读取.env文件（不依赖系统环境变量） #

使用django-environ库让Django直接从文件读取配置，无需依赖Cron的环境变量：

1. 安装依赖：pip install django-environ
2. 修改settings.py：

# settings.py
import environ

# 初始化环境变量读取器
env = environ.Env()
# 读取项目根目录下的.env文件
environ.Env.read_env()

# 用env()方法获取配置，替代os.environ.get()
SECRET_KEY = env('SECRET_KEY')
# 其他配置同理，比如DEBUG、DATABASE_URL等

额外调试建议 #

• 进入容器检查cron状态：docker exec -it django service cron status
• 给定时任务添加日志输出，方便排查：

# settings.py
CRONJOBS = [
    ('* * * * *', 'django.core.management.call_command', ['dumpdata_daily'], {}, '>> /code/cron_task.log 2>&1')
]

• 确认容器内用户对.env文件有读取权限：docker exec -it django ls -l /code/.env

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