如何让django-crontab在Docker容器中正常执行定时任务命令

问题核心原因 #

你遇到的问题是Docker容器内cron服务未启动、路径/环境变量不匹配导致的，具体修复步骤如下：

1. 启动cron服务

Docker容器默认仅运行一个主进程，你当前容器的主进程是Django开发服务器，虽然安装了cron、注册了定时任务，但cron后台服务根本没有运行，自然不会触发任务。
修改你的docker-entrypoint.sh（你笔误写成了docker-entrypoint.yml，实际是shell脚本），在crontab注册命令前添加cron服务启动指令：

# 启动cron服务
service cron start
# 原有注册定时任务的命令
python manage.py crontab add
python manage.py crontab show

2. 修复相对路径问题

cron任务执行时的默认工作目录是root用户的家目录/root，不是你的项目目录/back，你代码里用的./test.txt会被写入到/root/test.txt，而非项目目录下，会让你误以为任务没有执行。
两种修复方案二选一：

• 直接把cron.py里的路径改为绝对路径：with open("/back/test.txt", "a") as f
• 在settings.py中添加django-crontab配置，指定执行任务前切换到项目目录：

CRONTAB_COMMAND_PREFIX = 'cd /back && '

3. 补全环境变量

你在docker-compose中用了.env文件传递Django配置，cron任务执行时默认不会加载容器的环境变量，会导致Django读取配置失败、任务异常退出。
在docker-entrypoint.sh中添加一行指令，把容器环境变量导入到cron可读取的系统环境配置中：

printenv | grep -v "no_proxy" >> /etc/environment

4. 可选：拆分独立cron服务（生产环境推荐）

Docker最佳实践是一个容器运行一个进程，你可以把定时任务从webapp容器中拆分出来，单独在docker-compose.yml中添加一个cron服务：

services:
  # 原有db、webapp服务保持不变
  cron:
    build: ./back
    container_name: django_cron
    restart: unless-stopped
    env_file:
      - .env
    depends_on:
      - db
    volumes:
      - ./back:/back
    command: bash -c "python manage.py crontab add && cron -f"

拆分后webapp容器不需要再处理crontab相关逻辑，两个服务互不影响，稳定性更高。

调试方法 #

如果修改后还是不执行，可以进入容器手动执行crontab中注册的完整命令测试：

# 复制crontab -l输出的完整命令执行，看是否报错、是否生成test.txt
/usr/local/bin/python /back/manage.py crontab run ebcca28ea3199afe6d09a445db5d5fd8

也可以查看cron日志排查错误：cat /var/log/cron.log

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