Python Celery执行celery -A azima启动报错Invalid value的问题排查

你遇到的加载失败问题，本质是Celery 对 -A/--app 参数的默认查找规则，和当前项目结构没有匹配上。

核心原因拆解 #

Celery 解析启动参数、查找可运行的Celery应用实例时，会按固定优先级依次尝试：

• 首先尝试在参数指定的包路径下，自动加载名为celery的子模块，再从该模块中找名为celery或app的实例属性
• 如果第一步查找失败，会直接加载参数指定的模块本身，在模块的公开属性中查找名为celery或app的实例
• 以上流程全部匹配失败时，就会抛出你遇到的Module 'azima' has no attribute 'celery'报错

结合你当前的项目结构分析：
你执行的启动命令是celery -A azima，对应的查找流程为：

1. 第一步尝试在azima包目录下查找celery.py文件，当前目录下只有main.py、tasks.py，没有对应命名的模块，第一步直接失败
2. 第二步加载azima包本身，但你的azima/__init__.py是空文件，没有导出任何Celery实例属性，找不到对应名称的对象，第二步也失败，最终触发报错

之前你将main.py重命名为celery.py能正常运行，就是因为刚好匹配了Celery的第一步查找规则：Celery自动加载azima/celery.py里定义的app实例，不需要额外配置即可完成加载。

可落地的解决方案 #

不需要强制把文件改回celery.py，任选下面一种调整即可：

• 方案1：在azima/__init__.py中添加导出逻辑
  给空的__init__.py加一行导入语句，把你在main.py里定义的Celery实例暴露到包层级：

  from .main import app as celery_app
  

  调整后，azima包本身就拥有了名为celery的属性，完全匹配Celery的查找规则，原启动命令celery -A azima worker -l INFO可以直接正常运行。
• 方案2：直接调整启动命令的路径
  不需要修改任何代码，把启动命令改成明确指向你定义Celery实例的模块位置：

  celery -A azima.main worker -l INFO
  

  这个命令会让Celery直接跳过对azima包下celery.py的查找，直接加载azima.main模块里的app实例，和定义app的文件名没有关系。

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