Google云Ubuntu实例中Django crontab仅运行一次无法持久执行如何解决

1. 排查crontab运行日志 #

Ubuntu默认将crontab日志存在/var/log/syslog中，执行以下命令过滤相关日志，定位具体报错：

grep CRON /var/log/syslog

常见报错包括Python解释器路径不存在、项目目录找不到、依赖缺失、权限不足。

2. 修复Python环境匹配问题 #

如果你使用了虚拟环境，直接执行python manage.py crontab add会导致crontab生成的任务调用系统默认Python，和项目运行的虚拟环境不匹配，执行一次就报错终止。
解决方法：

• 添加任务时指定虚拟环境Python的绝对路径：

/home/你的用户名/虚拟环境目录/bin/python manage.py crontab add

• 也可以在settings.py中显式指定解释器路径：

CRONTAB_PYTHON_EXECUTABLE = "/home/你的用户名/虚拟环境目录/bin/python"

3. 配置项目绝对路径 #

crontab运行时无工作目录上下文，找不到Django项目根目录会导致执行失败，在settings.py中添加项目绝对路径配置：

CRONTAB_DJANGO_PROJECT_DIR = "/home/你的用户名/你的Django项目根目录路径"

4. 修复任务报错与锁冲突 #

如果你的定时任务函数抛出未捕获的异常，或者前一次运行的任务锁没有释放，都会导致后续任务不触发：

• 给所有cron函数添加异常捕获和日志输出，方便排查报错：

import logging
logger = logging.getLogger(__name__)

def cron_function():
    try:
        # 原有业务逻辑
    except Exception as e:
        logger.error(f"cron_function运行报错: {str(e)}", exc_info=True)

• 清理/tmp目录下前缀为django_crontab的锁文件，单VM场景下也可以在settings.py中关闭任务锁：

CRONTAB_LOCK_JOBS = False

5. 验证时间规则与时区配置 #

• 执行crontab -l查看生成的定时任务规则，确认和你配置的CRONJOBS规则一致。
• 执行timedatectl查看VM系统时区，如果和你预期的时区不符，会出现任务不在预期时段运行的问题，可执行以下命令修改时区（以上海时区为例）：

sudo timedatectl set-timezone Asia/Shanghai
sudo systemctl restart cron

所有配置修改完成后，先删除原有错误任务python manage.py crontab remove，再重新添加任务python manage.py crontab add即可。

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