将Django SECRET_KEY移入环境变量后Celery定时任务停止触发排查

问题根因 #

定时任务的调度由Celery Beat进程独立负责，你遇到的问题本质是Celery Beat进程启动时未加载到SECRET_KEY环境变量，导致配置加载异常、无法正常触发调度规则；而Celery Worker进程和Django应用启动时已经正确加载了环境变量，所以手动触发任务可以正常执行。

排查与解决方法 #

1. 给Celery Beat进程注入环境变量 #

Django应用、Celery Worker、Celery Beat是三个独立的进程，环境变量互不继承，需要给Beat进程单独配置和其他进程一致的环境变量：

• 若使用systemd管理进程：在Celery Beat的service配置文件[Service]段添加Environment="SECRET_KEY=你的实际密钥"，或者通过EnvironmentFile参数加载统一的环境变量配置文件
• 若使用Docker Compose部署：在celery-beat服务的配置中添加和Django、Worker服务一致的env_file或environment配置
• 若为本地终端启动：启动Beat前先执行export SECRET_KEY=你的实际密钥，和启动Django、Worker的前置操作保持一致

2. 增加环境变量读取校验 #

在settings.py中添加配置缺失的校验逻辑，避免静默失败无法定位问题：

import os
SECRET_KEY = os.environ.get("SECRET_KEY")
if not SECRET_KEY:
    raise ValueError("SECRET_KEY environment variable is not loaded")

配置后如果进程未加载到环境变量，启动时会直接抛出明确报错，方便快速定位。

3. 校验Celery Beat启动命令 #

确认启动Beat的命令指定了正确的配置模块，标准命令如下：

celery -A server beat -l info

确保-A参数指定的是Celery实例所在的server模块，保证Beat会正确加载server.settings的配置。

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