DEBUG设为False时Celery无法识别Django任务的问题排查

我之前也碰到过完全一致的问题，结合你的配置细节（子应用有独立AppConfig、DEBUG=True正常、关闭后任务未注册），主要有这几个可能的诱因：

1. 子应用AppConfig未在ready()方法中显式导入tasks模块 #

当DEBUG=False时，Django会切换到生产环境的应用加载逻辑，不会像DEBUG模式那样自动导入子应用的所有模块。如果你的子应用AppConfig没有在ready()方法里显式导入tasks文件，Celery的autodiscover_tasks()就可能找不到定义的任务。

解决方法：在每个子应用的apps.py中修改AppConfig类，添加ready()方法导入tasks：

from django.apps import AppConfig

class YourSubAppConfig(AppConfig):
    name = 'your_sub_app'

    def ready(self):
        # 显式导入tasks模块，确保Celery能发现任务
        import your_sub_app.tasks

2. autodiscover_tasks()未指定具体应用列表 #

你当前用的是无参数的app.autodiscover_tasks()，它默认会扫描INSTALLED_APPS中的应用，但在DEBUG=False时，Django的应用缓存或加载顺序可能发生变化，导致扫描遗漏。显式指定应用列表可以避免这个问题。

修改celery.py中的代码：

# 替换成你实际的子应用名称列表
app.autodiscover_tasks(['sub_app1', 'sub_app2', 'sub_app3'])

3. @shared_task未显式指定任务名称 #

在DEBUG模式下，Django会自动处理一些模块路径的兼容性，但关闭DEBUG后，如果没有给@shared_task指定name参数，可能会出现任务注册名称和调用时的名称不匹配的情况（比如模块导入路径变化导致任务名不一致）。

解决方法：给每个任务显式命名：

from celery import shared_task

@shared_task(name='sub_app1.your_task_name')
def your_task():
    # 任务逻辑
    pass

4. Celery Worker未重启（容易忽略的细节） #

当你调整了配置或代码后，DEBUG=False时Celery Worker不会自动重载，依然使用旧的任务注册信息。务必手动重启Worker进程，确保新的配置和任务被加载。

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