Docker容器中Django crontab无法执行且无日志问题求助

问题情况 #

在Django应用中配置了简单的crontab定时任务，已完成添加并启动cron服务，但任务既不自动执行，也不生成日志。手动执行python3 manage.py crontab run <cron_id>命令可正常运行，但日志文件始终为空。

相关配置 #

settings.py #

INSTALLED_APPS = [
    'django_crontab',
]

CRONJOBS = [
    ('*/1 * * * *', 'myapp.cron.test_func', '>> /var/log/cron.log 2>&1'),
]

Dockerfile #

FROM python:3.12
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

WORKDIR /app

COPY requirements.txt .

RUN pip3 install --upgrade pip
RUN pip3 install --no-cache-dir -r requirements.txt

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

RUN touch /var/log/cron.log

docker-entrypoint.sh #

python3 manage.py crontab add
service cron start

exec "$@"

容器内检查结果 #

• 执行crontab -l的输出：

  */1 * * * * /usr/local/bin/python3 /app/manage.py crontab run <cron_id> >> /var/log/cron.log 2>&1 # django-cronjobs for my_project
  

• 执行python3 manage.py crontab show的输出：

  <cron_id> -> ('*/1 * * * *', 'myapp.cron.test_func', '>> /var/log/cron.log 2>&1')
  

• 执行service cron status的输出：

  cron is running.
  

排查与解决方向 #

1. 日志文件权限问题 #

cron进程执行时可能没有写入/var/log/cron.log的权限。可在Dockerfile中添加权限设置：

RUN touch /var/log/cron.log && chmod 666 /var/log/cron.log

或者将日志路径改为容器内工作目录下的文件（权限更易控制），修改settings.py中的CRONJOBS：

CRONJOBS = [
    ('*/1 * * * *', 'myapp.cron.test_func', '>> /app/cron.log 2>&1'),
]

并在Dockerfile中创建该文件：

RUN touch /app/cron.log

2. 确保定时任务函数有输出 #

如果test_func本身没有任何输出（print或日志记录），即使任务执行，日志文件也会为空。可以在函数中添加明确的输出：

# myapp/cron.py
import datetime

def test_func():
    # 直接print输出（配合PYTHONUNBUFFERED=1可实时写入日志）
    print(f"任务执行于: {datetime.datetime.now()}")

3. Docker中cron进程的存活问题 #

Docker容器默认以前台进程为主进程，service cron start是后台启动cron，若后续exec "$@"启动的进程退出，容器会终止，cron也会停止。可使用进程管理工具（如supervisord）来管理cron和Django进程，确保两者持续运行：

• 在Dockerfile中安装supervisord：

  RUN apt-get install -y supervisor
  

• 创建supervisord配置文件/etc/supervisor/conf.d/supervisord.conf：

  [supervisord]
  nodaemon=true
  
  [program:cron]
  command=/usr/sbin/cron -f
  stdout_logfile=/var/log/cron_stdout.log
  stderr_logfile=/var/log/cron_stderr.log
  
  [program:django]
  command=python manage.py runserver 0.0.0.0:8000
  directory=/app
  stdout_logfile=/var/log/django_stdout.log
  stderr_logfile=/var/log/django_stderr.log
  

• 修改docker-entrypoint.sh，替换原有cron启动命令：

  python3 manage.py crontab add
  exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.conf
  

4. 检查cron系统日志 #

在容器内执行tail -f /var/log/syslog（若文件存在），可查看cron是否尝试执行任务，以及执行失败的具体原因（如权限错误、路径错误等）。若syslog不存在，可在Dockerfile中安装rsyslog来收集cron日志：

RUN apt-get install -y rsyslog
RUN sed -i '/imklog/s/^/#/' /etc/rsyslog.conf

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