必须配置 celery_beat_scheduler 为 "django_celery_beat.schedulers:databasescheduler" 并完成迁移、时区设置及任务路径验证，否则定时任务将静默失效。
直接用 django-celery-beat，别自己写 cron 或后台线程——它能持久化任务、支持管理后台修改、避免进程重复启动，但配置错一步，任务就静默失效。
CELERY_BEAT_SCHEDULER 配置必须指向 DatabaseScheduler
默认的 celery beat 把任务规则存在内存里，Django 重启后全丢。要让定时任务真正“记住”，必须切到数据库驱动：
-
CELERY_BEAT_SCHEDULER必须设为"django_celery_beat.schedulers:DatabaseScheduler"，不能漏掉引号或拼错路径 -
INSTALLED_APPS里得有'django_celery_beat'和'django_celery_results'（后者非必须，但查执行记录很依赖它） - 运行
python manage.py migrate—— 表periodictask、intervalschedule等必须存在，否则 beat 启动直接报ProgrammingError - 别在
CELERY_BEAT_SCHEDULE里配任务：用了 DatabaseScheduler，这个字典配置就完全失效，所有任务都得走数据库或管理后台
启动 beat 进程前必须确保 Django 已初始化
常见报错 AppRegistryNotReady: Apps aren't loaded yet，根本原因是 celery beat 进程启动太快，Django 的 App registry 还没加载完。这不是 celery 版本问题，是调用时机问题：
- 在
celery.py中，django.setup()必须放在Celery(...)实例创建之后、任何配置（如app.conf.beat_schedule）之前 - 不要在
apps.py的ready()方法里启动 scheduler，它会被每个 app 触发一次 - 开发时用
python -m celery -A myproject beat -l info启动，别用runserver自带的多线程模式跑 beat - 生产环境用 systemd 或 supervisor 管理 beat 进程，确保它和 worker 是独立进程，且只启一个实例
时区错乱会导致任务在错误时间执行
你设了每天 9:00 执行，结果凌晨 1:00 就跑了——大概率是 Celery 默认用 UTC，而 Django TIME_ZONE = 'Asia/Shanghai' 没被正确继承：
-
CELERY_TIMEZONE必须显式设为'Asia/Shanghai'，不能只靠TIME_ZONE -
CELERY_ENABLE_UTC推荐设为False；设True的话，所有 crontab 表达式和时间字段都得手动转成 UTC，极易出错 - 数据库里
PeriodicTask的start_time和last_run_at字段，如果存的是 naive datetime（没 tzinfo），后续调度会漂移——用pytz.timezone('Asia/Shanghai').localize(...)构造带时区的时间对象 - 检查
django-celery-beat是否用了APSCHEDULER_DATETIME_FORMAT：这个配置只对 APScheduler 有效，对 DatabaseScheduler 无效，别混用
任务函数路径必须可 import 且带 @shared_task 装饰
管理后台点了“启用”，但任务就是不进队列——90% 是函数路径写错或没被 celery 加载：
- 在管理后台新建
PeriodicTask时，“Task”字段填的是字符串，比如myapp.tasks.cleanup_expired，不是函数对象 - 对应模块
myapp/tasks.py必须存在，且其中的cleanup_expired函数必须用@shared_task（或@app.task）装饰 - 验证方式：在项目根目录下运行
python -c "from myapp.tasks import cleanup_expired"，不报错才算可 import - 别把清理逻辑直接写在
tasks.py里：推荐抽成management/commands/clean_expired.py，再让 task 调用call_command('clean_expired')—— 这样命令行可调试、事务上下文自动生效、ORM 信号也能触发
最易忽略的一点：DatabaseScheduler 不会自动 reload 任务列表。改了数据库里的 PeriodicTask，beat 进程得手动重启（或发 SIGHUP）才能生效；如果用了 django-admin runscript 动态注册，那更得确认脚本是否真被 beat 进程 import 到了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
