Django-crontab定时任务不自动执行问题求助

环境与配置 #

• 依赖版本：django4.2.1、django-crontab0.7.1，采用Docker-Compose部署
• docker-compose.yml启动命令：

web:
  build: .
  ports:
    - "8000:8000"
  volumes:
    - .:/app
  depends_on:
    postgres_db:
      condition: service_healthy
    queue:
      condition: service_started
  environment:
    - PYTHONUNBUFFERED=1
  entrypoint: ["/bin/bash", "-c"]
  command:
    - |
      python manage.py makemigrations
      python manage.py migrate
      python manage.py crontab remove
      python manage.py crontab add
      python manage.py sync_cronjobs
      python manage.py runcrons
      python manage.py runserver 0.0.0.0:8000

• Dockerfile配置：

FROM python:3.11.3
LABEL authors="AM"
WORKDIR /app
COPY Pipfile Pipfile.lock ./

RUN python -m pip install --upgrade pip &&  \
    pip install --no-cache-dir pipenv &&  \
    pipenv install --dev --system --deploy

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

COPY . .

当前现象 #

• 手动运行单个任务（如python manage.py crontab run 373fcec9cd7d9ec8d95e7cb90d031caf）正常，有日志反馈
• python manage.py crontab show能看到所有活跃任务列表：

python manage.py crontab show
Currently active jobs in crontab:
373fcec9cd7d9ec8d95e7cb90d031caf -> ('*/4 * * * *', 'AHC_app.celery_notifications.cron.send_emails')
3a8ed9c92a09c1a2fda1d6342949389d -> ('*/2 * * * *', 'AHC_app.celery_notifications.cron.send_email_example')
0d0751f76f6d5de0ba21d6984ba14cfd -> ('4 * * * *', 'AHC_app.celery_notifications.cron.send_sms')
7926f3cc17e62d57da2eff317a33f1a7 -> ('6 * * * *', 'AHC_app.celery_notifications.cron.send_discord_notes')

• 执行python manage.py crontab run不带任务hash时，报错：

python manage.py crontab run
<...>
RuntimeError: No job with hash None found. It seems the crontab is out of sync with your settings.CRONJOBS. Run "python manage.py crontab add" again to resolve this issue!

• 所有定时任务均不按settings.py中的CRON表达式自动执行

解决建议 #

• 确保容器内cron服务正常运行
  django-crontab依赖系统cron服务，容器启动时默认可能未启动该服务：

  1. 进入容器执行service cron status检查状态，未启动则执行service cron start
  2. 将启动cron的命令加入docker-compose启动脚本，调整后的command如下：

     python manage.py makemigrations
     python manage.py migrate
     service cron start
     python manage.py crontab remove
     python manage.py crontab add
     python manage.py runserver 0.0.0.0:8000
     

  注：runcrons是一次性触发所有任务的命令，会阻塞后续启动流程，无需加入持续运行的启动脚本；sync_cronjobs若不是项目必需可移除。

• 验证crontab实际内容一致性
  进入容器执行crontab -l，查看系统crontab中的条目是否与python manage.py crontab show输出一致。若不一致，重新执行python manage.py crontab remove && python manage.py crontab add生成任务。

• 配置容器时区
  cron任务执行时间依赖容器时区，若时区与预期不符会导致任务错峰执行：

  1. 在Dockerfile中添加时区配置：

     RUN apt-get install -y tzdata
     ENV TZ=Asia/Shanghai
     

  2. 或在docker-compose.yml的environment字段添加TZ=Asia/Shanghai（替换为你的目标时区）。

• 添加日志输出排查问题
  为CRONJOBS配置日志输出，便于查看任务是否触发及执行错误：
  在settings.py的CRONJOBS中添加日志重定向：

  CRONJOBS = [
      ('*/4 * * * *', 'AHC_app.celery_notifications.cron.send_emails', '>> /app/cron_send_emails.log 2>&1'),
      ('*/2 * * * *', 'AHC_app.celery_notifications.cron.send_email_example', '>> /app/cron_example.log 2>&1'),
      # 其他任务同理
  ]
  

  执行任务后查看对应日志文件，定位是否有执行报错。

• 检查django-crontab配置正确性

  1. 确认settings.py中CRONJOBS格式正确，每个条目为(定时表达式, 任务路径, 可选参数)的结构
  2. 确保任务函数可正常调用，无导入错误或依赖缺失
  3. 若需指定执行用户，检查是否配置了CRONTAB_USER参数

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