Django项目Celery Worker启动报错：'NoneType'无Redis属性

可能原因 #

• Redis Python客户端包异常：虚拟环境中的redis包损坏或导入路径错误，导致kombu（Celery依赖的消息库）尝试调用redis.Redis时获取到None对象。
• Celery配置未正确加载：Django项目的Celery配置未被实例文件正确读取，导致Broker/Result Backend初始化失败。
• 版本兼容隐藏问题：虽然已确认版本，但部分celery/kombu/redis版本组合存在适配bug，引发导入错误。

解决方法 #

1. 修复Redis Python客户端 #

• 激活虚拟环境，彻底卸载并重装redis包：

  pip uninstall -y redis
  pip install redis==4.5.5  # 选择Celery官方兼容的稳定版本
  

• 验证导入是否正常：在虚拟环境的Python Shell中执行：

  import redis
  print(redis.Redis)
  

  若输出<class 'redis.client.Redis'>则正常；若报错，需检查虚拟环境是否激活，或重新创建虚拟环境后重装依赖。

2. 确认Celery配置加载逻辑 #

• 检查Celery实例文件（如main.py）是否正确加载Django配置：

  import os
  from celery import Celery
  
  # 必须设置Django配置模块环境变量
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
  app = Celery('main')
  # 从Django settings加载配置，namespace确保配置项前缀为CELERY_
  app.config_from_object('django.conf:settings', namespace='CELERY')
  # 自动发现各app中的tasks.py
  app.autodiscover_tasks()
  

• 确认Redis服务运行状态：

  systemctl status redis-server
  

  若未运行，启动服务并设置开机自启：

  systemctl start redis-server
  systemctl enable redis-server
  

3. 强制指定兼容版本组合 #

• 查看当前依赖版本：

  pip freeze | grep -E 'celery|kombu|redis'
  

• 安装经验证的兼容版本（以Celery 5.3.x为例）：

  pip install celery==5.3.4 kombu==5.3.2 redis==4.5.5
  

4. 额外排查 #

• 若使用虚拟环境，确保启动Celery Worker时已激活虚拟环境：

  source 你的虚拟环境路径/bin/activate
  celery -A main worker -l info
  

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