一聚教程网:一个值得你收藏的教程网站

最新下载

热门教程

Djangocelery 配置踩坑大全:celery.py 放哪里?任务队列用 redis 还是 db?

时间:2026-07-23 09:04:01 编辑:袖梨 来源:一聚教程网

主要是自己学习使用celery过程中遇到的问题,自己记录使用,其他同学也可以借鉴。

一、环境准备

  • Django 4.1.5
  • celery 5.4.0
  • redis 4.5.1
  • django-celery-results 2.5.1

其他项目需要的安装包自行安装。

二、celery的配置

celery.py文件:

from __future__ import absolute_import, unicode_literals
import os
from celery import Celery
from django.conf import settings

# 设置Django的settings模块
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'testplatform.settings')

app = Celery('testplatform')

# 使用Django的settings文件来配置Celery
app.config_from_object('django.conf:settings', namespace = 'CELERY')

# 自动从所有已注册的Django app中加载任务
app.autodiscover_tasks(lambda: settings.INSTALLED_APPS)


@app.task(bind = True)
def debug_task(self):
    print(f'Request: {self.request!r}')

这些网上都有,照抄就行。

下面是坑。

坑一:

celery.py文件必须放在和setting.py文件同一目录下,不要放在最外层的根目录下。如果放在最外层的根目录下会出现什么问题:

1、如果命名为celery.py,那么在导入from celery import Celery时,会报错,与celery包有冲突,导致无法使用;

2、如果换成别的名字,譬如celeryConfig.py(文件内的内容不变),虽然不冲突了,但是在后续起服务时会出现N多问题!!!

坑二:

与celery.py同级的__init__.py文件中需要引入app(app是celery中创建的实例)

from .celery import app

如果不这么写,后续在视图函数中,会无法使用@shared_task 装饰器,只能用@app.task ,(@shared_task相当于是@app.task的一个"快捷方式"),让人摸不着头脑。

setting.py文件:

坑一:

关于CELERY_BROKER_URL和CELERY_RESULT_BACKEND的属性,一开始问文心一言,告诉我CELERY_RESULT_BACKEND="django-celery-results",结果启动失败,后来告诉我使用CELERY_RESULT_BACKEND="django-db",虽然启动成功了,任务并没有执行。

建议任务队列和结果队列都写成redis

CELERY_BROKER_URL = f'redis://:{REDIS_PW}@{REDIS_IP}:{REDIS_PORT}/0'  # Redis数据库地址
CELERY_RESULT_BACKEND = f'redis://:{REDIS_PW}@{REDIS_IP}:{REDIS_PORT}/1' 
CELERY_ACCEPT_CONTENT = ['application/json']
CELERY_TASK_SERIALIZER = 'json'
CELERY_RESULT_SERIALIZER = 'json'
CELERY_TIMEZONE = 'Asia/Shanghai'  # 根据需要调整时区
CELERY_BROKER_CONNECTION_RETRY_ON_STARTUP = True

坑二:

排雷过程中还遇到一种做法,在INSTALLED_APPS中加入"django_celery_results",后来发现不写也可以,完全没影响,也没用到吧。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'app01.apps.App01Config',
    'django_celery_results'
    ]

视图函数,以及异步任务没啥好讲的,网上都有。

以下是我练习时用的。

@csrf_exempt
def reset_data_api(request):
    # 调用异步任务
    result = reset_data.delay()
    task_id = result.task_id
    return JsonResponse({'status': True, 'data': {'message': '任务开始执行', 'task_id': f'{task_id}'}})

@shared_task
def reset_data():
    logger.info('开始执行任务')

    result = {
        "a": 123,
        "b": 456
        }
    logger.info('结束执行任务')
    return result

三、celery的运行

遇到最大的坑!!!!:

很难想象,celery服务器启动是正常的,任务消息也能收到,redis服务都是正常的,也没有任何报错信息,但是异步任务就是不执行,存放result的队列就是没数据,搞了大半天,晚上也睡好,想不明白。

问文心一言,也完全找不到原因,各种排查。最后是在百度上搜,才发现原因:

celery正常启动后能收到任务但不执行任务的解决

celery在windows下的运行是有问题,需要借助gevent,eventlet 等才能实现正常功能。

pip安装 eventlet后再运行celery就行了

Djangocelery配置踩坑大全:celery.py放哪里?任务队列用redis还是db?

Djangocelery配置踩坑大全:celery.py放哪里?任务队列用redis还是db?

基本上就这些了,后面使用过程中还有的话,继续补充~~

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持本站。

您可能感兴趣的文章:
  • celery是什么?一文带你搞懂任务队列和worker原理(Django环境)
  • django项目如何用celery实现异步任务?完整步骤分享
  • Django Celery Redis异步发邮件怎么做?完整配置教程分享
  • Celery定时任务组件之Django+Celery项目实战教程
  • django+celery如何实现定时拉取阿里云rocketmq实例信息
  • django celery定时任务实战详解

热门栏目