Python3.10.6中Celery最新版本循环导入ImportError问题求助

问题根源 #

从错误回溯能直接定位问题：你项目根目录下的celery.py文件名，和Celery官方库的模块名完全重名了。

• 当django_celery_beat尝试导入celery模块时，Python会优先加载你项目里的celery.py，而非第三方库的Celery模块。
• 你的celery.py又要从celery导入Celery类，形成循环导入，最终触发报错。

解决步骤 #

• 重命名项目内的Celery配置文件：把项目根目录下的celery.py改成其他名称，比如celery_app.py，彻底避免命名冲突。
• 同步更新引用路径：如果项目里其他文件（比如settings.py、业务app的代码）导入过这个文件，要同步修改导入路径，确保指向新文件名。
• 清理缓存文件：删除项目根目录及各app目录下的__pycache__文件夹，防止旧缓存的模块信息干扰。
• 重启相关服务：重新启动Django开发服务器和Celery worker进程，确保加载新的模块文件。

错误回溯信息 #

Traceback (most recent call last):
  File "/usr/lib/python3.10/threading.py", line 1016, in _bootstrap_inner
    self.run()
  File "/usr/lib/python3.10/threading.py", line 953, in run
    self._target(*self._args, **self._kwargs)
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/utils/autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/core/management/commands/runserver.py", line 110, in inner_run
    autoreload.raise_last_exception()
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/utils/autoreload.py", line 87, in raise_last_exception
    raise _exception[1]
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/core/management/__init__.py", line 375, in execute
    autoreload.check_errors(django.setup)()
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/utils/autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/apps/registry.py", line 114, in populate
    app_config.import_models()
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django/apps/config.py", line 301, in import_models
    self.models_module = import_module(models_module_name)
  File "/usr/lib/python3.10/importlib/__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 883, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "/home/biju/Desktop/trial/lib/python3.10/site-packages/django_celery_beat/models.py", line 10, in <module>
    from celery import current_app, schedules
  File "/home/biju/Desktop/trial/celery.py", line 3, in <module>
    from celery import Celery
ImportError: cannot import name 'Celery' from partially initialized module 'celery' (most likely due to a circular import) 

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