Win10下Django集成Celery遇ImportError:无法导入'_state'（循环导入）

问题根源 #

你的项目根目录被加入Python模块搜索路径，Celery内部代码尝试导入自身的config模块时，误导入了你项目中的config目录，引发循环引用。

解决方案 #

1. 重命名项目的config目录（推荐）

这是最彻底的解决办法，避免模块名冲突：

• 将settings所在的config目录重命名为非冲突名称（比如project_config）
• 同步修改所有相关路径：
  • manage.py中修改settings模块路径：

    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'project_config.settings')
    

  • 新目录下的celery.py中更新配置：

    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'project_config.settings')
    app = Celery('project_config')
    

  • 新目录下的__init__.py保持导入逻辑不变：

    from .celery import app as celery_app
    

  • 启动Celery时指定正确的应用名：

    celery -A project_config worker -l info
    

2. 调整模块搜索优先级（不推荐，仅当无法重命名目录时使用）

在celery.py最顶部添加代码，确保Celery优先加载自身模块：

import sys
from pathlib import Path

# 将Celery的安装目录加入搜索路径最前端
celery_install_path = Path(__file__).parent.parent / "venv" / "Lib" / "site-packages" / "celery"
sys.path.insert(0, str(celery_install_path))

# 后续正常导入Celery并配置
import os
from celery import Celery

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
app = Celery('config')
app.config_from_object('django.conf:settings', namespace='CELERY')
app.autodiscover_tasks()

3. 检查Celery配置的完整性

确保celery.py中正确初始化Django环境，且所有路径与项目结构匹配，避免因路径错误间接引发导入问题。

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