Django-crontab在Docker容器中定时任务不自动执行问题咨询

你的配置存在3处直接导致定时任务无法自动触发的硬错误：

• entrypoint.sh逻辑冲突：cron容器启动流程中，你先启动cron、注册完定时任务就主动执行service cron stop关闭服务，后续前台启动的cron进程虽然会读取crontab配置，但你没有提前配置cron运行Django任务所需的环境变量、文件权限
• 路径与环境变量缺失：django-crontab默认生成的定时任务依赖相对路径，而cron运行时默认工作目录为root用户家目录，不会继承容器内配置的PATH等环境变量，根本找不到Python解释器和manage.py文件，执行直接报错但无日志输出
• 权限不符合要求：Debian系的cron服务强制要求crontab配置文件权限为600、属主为root，否则会静默忽略所有定时任务，不输出任何报错
  另外你没有配置定时任务的输出重定向，cron默认会把任务的标准输出、错误信息通过本地邮件服务发送，容器内未启动邮件服务时这些信息会直接丢弃，完全无法排障。

1. 修正entrypoint.sh逻辑 #

删除多余的cron启停操作，补充环境变量注入、权限修正逻辑，替换为以下内容：

#!/bin/sh
set -e

# 仅cron容器执行初始化逻辑
if [ "$1" = "cron" ]; then
    # 将容器当前环境变量注入cron运行环境，跳过不需要的代理变量
    printenv | grep -v "no_proxy" >> /etc/environment
    # 用绝对路径注册Django定时任务
    python /app/manage.py crontab add
    # 强制修正crontab文件权限，满足cron加载要求
    chmod 0600 /var/spool/cron/crontabs/root
    chown root:crontab /var/spool/cron/crontabs/root
fi

# 启动传入的服务命令
exec "$@"

2. 修正Django定时任务配置 #

在settings.py中补充绝对路径配置、任务日志重定向，避免cron环境找不到资源：

# 先在容器内执行`which python`确认Python解释器实际路径，替换下方值
CRONTAB_PYTHON_EXECUTABLE = '/usr/local/bin/python'

CRONJOBS = [
    # 最后一个参数为日志重定向规则，把任务所有输出写到日志文件
    ('*/1 * * * *', 'apps.coupons.cron.test', '>> /app/file.log 2>&1'),
]

# 任务执行前先切换到项目根目录，避免相对路径报错
CRONTAB_COMMAND_PREFIX = 'cd /app && '

3. 调整cron服务启动参数 #

修改docker-compose.yml中cron服务的启动命令，开启cron日志方便排障：

cron:
        build:
            context: ./
            dockerfile: ./devops/Dockerfile
            args:
                [Bunch of parameters]
        container_name: cron
        volumes:
            - ./project:/app
        environment:
            [Bunch of parameters]
        # 开启cron debug级日志，输出到容器标准输出
        command: cron -f -L 15

4. （可选）补充时区配置 #

cron按容器内部时间触发任务，如果容器时区和本地时区不一致，会出现任务触发时间和预期不符的问题，可在Dockerfile中添加时区配置：

# 安装cron时顺便配置时区
RUN apt-get update && apt-get -y install cron tzdata
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

重新构建启动容器后，按以下步骤验证：

• 进入cron容器执行crontab -l，确认注册的任务中所有路径均为绝对路径
• 执行docker logs -f cron查看cron服务日志，等待1分钟左右可看到任务触发记录
• 查看项目目录下的file.log，确认测试任务的日志输出正常

如果配置完成后任务仍不触发，90%以上为路径或环境变量问题：

• 复制crontab -l输出的完整任务执行命令，在cron容器内直接执行，看是否报错
• 查看cron服务的标准输出日志，所有cron层面的执行报错都会打印在这里
• 不要在cron任务中依赖相对路径读文件，所有路径统一写绝对路径

内容的提问来源于stack exchange，提问作者Efraín