通过supervisord启动Celery无法自动发现任务问题排查

这问题我之前碰到过好几次，大概率是Supervisor的环境变量、权限或者配置细节导致Celery没法正确加载Django的应用配置和自定义任务，给你几个具体的排查方向：

1. 检查Supervisor的环境变量配置是否完整 #

你当前的environment只设置了PATH，但Celery启动时需要正确的Django环境变量支撑。建议补充以下环境变量：

environment=PATH="/home/ubuntu/Env/oba/bin", DJANGO_SETTINGS_MODULE="oba.settings", PYTHONPATH="/home/ubuntu/oba"

解释一下：

• DJANGO_SETTINGS_MODULE：确保Celery能找到Django的配置文件
• PYTHONPATH：让Python能识别你的项目根目录，避免导入模块失败

修改后重启Supervisor（supervisorctl reload）再测试。

2. 验证Celery用户的权限与执行环境 #

你配置了user=celery，但这个用户可能没有足够的权限访问项目文件，或者它的执行环境和你命令行的环境不一样。

• 切换到celery用户手动执行Celery启动命令，看是否能加载任务：

su celery -c "/home/ubuntu/Env/oba/bin/celery -A oba worker -l DEBUG"

如果这时候也看不到自定义任务，说明不是Supervisor的问题，而是celery用户本身的环境或权限问题；如果能看到，那问题就出在Supervisor的配置细节上。

• 检查项目目录和文件的权限：确保/home/ubuntu/oba及其子目录、文件对celery用户有可读权限。

3. 确认Celery自动发现任务的配置正确性 #

• 先检查oba/settings.py里的INSTALLED_APPS是否包含了'contact'这个应用，没有的话Celery根本不会去扫描它的tasks。
• 确认contact/tasks.py的文件名拼写正确（是tasks.py不是task.py），并且文件里的@shared_task是正确导入的：

from celery import shared_task  # 必须是这个导入

• 你当前的celery.py里用了app.autodiscover_tasks(lambda: settings.INSTALLED_APPS)，这个写法是对的，但可以临时改成app.autodiscover_tasks()（默认就是扫描INSTALLED_APPS）试试，排除lambda表达式的潜在问题。

4. 查看Celery日志找报错信息 #

去查看Supervisor配置的日志文件/var/log/celery/celery.log，尤其是DEBUG级别的日志，里面会显示Celery扫描任务的过程：

• 有没有出现类似ImportError的报错？
• 有没有显示“Scanning modules for tasks”相关的信息，是否提到了contact.tasks？
  日志里的错误信息往往是定位问题最直接的线索。

5. 正确使用Celery inspect命令 #

你执行inspect registered返回空，可能是因为命令的执行环境和Worker的环境不一致。试试用celery用户执行该命令，确保和Worker用相同的权限和环境：

sudo -u celery /home/ubuntu/Env/oba/bin/celery -A oba inspect registered

如果Worker正常运行且能发现任务，这个命令应该能返回你的自定义任务列表。

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