Django Celery仅在生产环境出现App导入错误问题求助

问题根因分析 #

以下是最可能触发该报错的几类原因，优先级从高到低排列：

1. 拼写不匹配问题
   你的项目目录中子应用文件夹名为 artist_applications（复数带s），但 settings.py 的 INSTALLED_APPS 中注册的是 myapp.artist_application（单数无s）。如果开发环境是Windows/macOS（系统对文件名拼写/大小写容错度高）就可以正常运行，而生产环境常用的Linux系统对文件名严格匹配，就会触发导入失败。
2. App配置类属性错误
   报错提示已经明确指向需要检查 ArtistApplication.name 配置：子应用下 apps.py 中配置类的 name 属性，必须和 INSTALLED_APPS 中注册的路径完全一致，如果拼写少了前缀或者写错了名称，就会加载失败。
3. Celery启动工作目录错误
   Django的 runserver、uWSGI/WSGI 服务启动时，会自动将项目根目录（包含 myapp 文件夹的上层目录）加入Python的模块搜索路径 sys.path，但手动执行Celery命令时，如果当前工作目录不是项目根目录，Python就找不到 myapp 包，自然无法导入子应用。开发环境你大概率是在根目录执行的命令，生产环境可能切换到了其他目录执行。
4. 代码同步疏漏
   可能存在生产环境代码同步不全的问题：比如漏了 artist_applications 目录下的 __init__.py 文件，没有该文件Python不会将文件夹识别为可导入的包。
5. 虚拟环境路径配置缺失
   生产环境的虚拟环境没有将项目根目录加入模块搜索路径，导致只有在根目录执行命令才能正常导入模块，其他目录执行就报错。

另外注意你贴出的 tasks.py 代码存在明显笔误：导入的Celery实例名为 celery_myapp，但任务装饰器用的是 @celery_esns.task，如果实际代码也是这个问题需要同步修正。

排查步骤 #

1. 核对三处拼写完全一致：生产环境myapp目录下的子应用文件夹名、INSTALLED_APPS中注册的子应用路径、apps.py中配置类的name属性，三者必须完全相同。
2. 确认子应用配置正确，artist_applications/apps.py的结构应符合以下要求：

from django.apps import AppConfig

class ArtistApplicationConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'myapp.artist_applications' # 此处和INSTALLED_APPS注册值完全一致

3. 修正Celery启动路径：执行Celery命令前先cd到项目根目录（执行ls命令可以看到myapp文件夹的目录），再执行启动命令测试。
4. 验证模块导入：在生产环境虚拟环境中，进入之前执行Celery命令的目录，打开Python shell执行以下代码排查路径问题：

# 先直接导入测试
import myapp.artist_applications

# 如果上面报错，手动加路径再测试，替换成你实际的项目根目录路径
import sys
sys.path.append("/path/to/your/project/root")
import myapp.artist_applications

如果加路径后可以正常导入，说明是模块搜索路径问题，可以在celery.py开头添加上述路径新增代码，或者配置系统环境变量PYTHONPATH为项目根目录。
5. 检查artist_applications目录下是否存在__init__.py文件，为空也可以，必须存在。

内容的提问来源于stack exchange，提问作者A. Nurb