celery定时任务不触发的主因是celery beat未启动或未加载django配置，需在celery.py中调用django.setup()、正确定义celery_beat_schedule、分开运行worker和beat进程，并注意时区、broker连接、django初始化顺序及task参数序列化问题。
为什么 Celery 的定时任务在 Django 里不触发？
绝大多数情况不是代码写错了，而是 celery beat 进程根本没启动，或者启动时没加载 Django 配置。Celery 默认不自动读取 Django 的 settings.py，必须显式配置 app.autodiscover_tasks() 并设置 django.setup() 环境。
实操建议：
- 在
proj/celery.py中确保调用django.setup()（在import os后、Celery()实例化前） -
CELERY_BEAT_SCHEDULE必须定义在 Django settings 模块中（如settings.py），且需通过app.conf.beat_schedule = settings.CELERY_BEAT_SCHEDULE或直接在celery.py中赋值 - 启动命令必须分开：一个终端跑
celery -A proj worker -l info，另一个跑celery -A proj beat -l info；合并在一个命令里（比如加--beat）容易掩盖调度器异常 - 注意时区：Django 默认用
TIME_ZONE = 'UTC'，但CELERY_TIMEZONE若设为'Asia/Shanghai'而未同步设置CELERY_ENABLE_UTC = False，会导致计划时间偏移 8 小时
如何让 send_mail_task 正确访问 Django ORM 和邮件后端？
直接在 task 函数里 import model 或调用 send_mail() 很可能报 django.core.exceptions.AppRegistryNotReady: Apps aren't loaded yet，因为 Celery worker 启动时未触发 Django app 初始化。
实操建议：
- 所有涉及模型或 Django 内建功能（如
send_mail、get_object_or_404）的逻辑，必须包裹在django.db.transaction.atomic()或至少确保在 task 函数体内调用前已就绪 - 推荐写法：在 task 函数开头加
from django.core.mail import send_mail和from myapp.models import User—— 不要提前 import 到模块顶层 - 避免在 task 中硬编码邮件内容，改用模板：用
render_to_string('email/welcome.txt', {'user': user})，并确保TEMPLATES配置中的DIRS包含模板路径 - 测试时用
EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'，避免误发；上线前切到smtp并检查EMAIL_HOST_USER和EMAIL_HOST_PASSWORD是否被环境变量正确注入
CELERY_RESULT_BACKEND 设置成 redis 还是 database？
如果只是发邮件这种「只关心是否执行成功、不查返回值」的任务，CELERY_RESULT_BACKEND 其实可以关掉（设为 None）。开它反而增加 Redis 压力和失败风险。
实操建议：
- 确认你真的需要
task.get()或task.ready()：比如前端轮询任务状态、或链式任务依赖结果 —— 否则设task_ignore_result = True更轻量 - 若必须存结果，redis 比 database 快，但要注意版本兼容性：
redis-py >= 4.0与 Celery 5.2+ 兼容，旧版 redis 可能导致ConnectionError - database 方案（
django-db）需运行python manage.py migrate django_celery_results，且每次查询 result 会触发一次 DB 查询，高并发下易成瓶颈 - 别把
BROKER_URL（消息队列）和RESULT_BACKEND混用同一个 Redis DB：建议 broker 用 db 0，result 用 db 1，避免 key 冲突
如何调试 beat 发送的邮件任务没收到？
最常被忽略的是日志粒度太粗，看不到 task 是没进队列、卡在序列化、还是执行时报错。
实操建议：
- 在 task 函数第一行加
print(f"[DEBUG] Running send_mail_task for user_id={user_id}")，配合worker -l info查看是否打印 —— 没打印说明没被调度或参数序列化失败 - 检查
celery beat输出里有没有类似Writing entries (1)，没有说明CELERY_BEAT_SCHEDULE为空或格式错误（比如用了datetime对象而非crontab或timedelta） - 临时把 task 的
@shared_task改成普通函数，在 shell 里手动调用：send_mail_task(123)，快速验证逻辑和邮件配置 - 用
celery inspect scheduled查看 beat 当前排期的任务列表，用celery inspect active看当前正在执行的 task —— 这两个命令必须在 worker 启动后执行，且要求CELERY_WORKER_SEND_TASK_EVENTS = True
时区、broker 连接、Django setup 顺序、task 参数序列化 —— 这四点出问题的概率加起来超过 80%，其他地方先别深挖。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
