You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

远程Ubuntu服务器用Supervisor运行Celery遇Django配置错误求助

解决Celery + Supervisor运行时DJANGO_SETTINGS_MODULE未定义的问题

从你的日志和错误提示来看,核心问题是Celery进程无法找到Django的配置文件,导致后续Django模型初始化失败(就是日志里的CharField报错)。下面是几种可靠的解决方法:

方法1:在Supervisor配置中添加环境变量

这是最直接规范的做法,修改你的Celery Supervisor配置文件(通常位于/etc/supervisor/conf.d/celery.conf),添加environment字段指定Django的settings模块:

[program:celery]
# Celery启动命令,替换your_project_name为你的实际Django项目名
command=/home/zorgan/app/env/bin/celery -A your_project_name worker --loglevel=info
# Django项目根目录
directory=/home/zorgan/app
# 设置Django环境变量,同样替换your_project_name
environment=DJANGO_SETTINGS_MODULE="your_project_name.settings"
# 运行用户
user=zorgan
autostart=true
autorestart=true
stdout_logfile=/var/log/supervisor/celery.log
stderr_logfile=/var/log/supervisor/celery.err.log

修改完成后,重启Supervisor服务使配置生效:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl restart celery

方法2:在启动命令中直接注入环境变量

如果你不想修改Supervisor的environment字段,可以通过bash命令先设置环境变量再启动Celery,修改配置中的command行:

command=/bin/bash -c "DJANGO_SETTINGS_MODULE=your_project_name.settings /home/zorgan/app/env/bin/celery -A your_project_name worker --loglevel=info"

同样执行上面的Supervisor重启命令即可。

方法3:在Celery配置文件中显式加载Django设置

如果上面两种方法都不方便,你可以在Celery的配置文件(比如项目根目录下的celery.py)中主动设置环境变量并加载Django配置:

import os
from celery import Celery

# 强制设置Django配置模块路径
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project_name.settings')

# 初始化Django环境
import django
django.setup()

# 初始化Celery app
app = Celery('your_project_name')
app.config_from_object('django.conf:settings', namespace='CELERY')
app.autodiscover_tasks()

额外检查点

  • 确认your_project_name.settings路径正确:你的Django项目根目录下必须存在your_project_name/settings.py文件(比如/home/zorgan/app/your_project_name/settings.py)。
  • 手动测试Celery命令:先激活虚拟环境source /home/zorgan/app/env/bin/activate,然后运行celery -A your_project_name worker --loglevel=info,看是否还会报相同错误,排除路径或虚拟环境问题。
  • 日志权限:确保zorgan用户有写入/var/log/supervisor/目录的权限,避免因权限问题导致日志异常。

一般来说,按方法1配置后就能解决问题,日志中的CharField初始化错误也会因为Django环境正常加载而自动消失。

内容的提问来源于stack exchange,提问作者Zorgan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.26 08:44:45