用途:为 Celery 应用实现高级任务路由与队列管理,包括优先级队列、基于主题的路由和按工作进程分配队列,用于性能优化、优先级管理、资源隔离与独立扩展。支持 RabbitMQ、Redis 和自定义 broker 配置。
主要能力:提供脚本 scripts/test-routing.sh <config-file>,校验路由配置与队列连通性(broker 连接、队列声明、交换机配置、路由键模式、worker 绑定、优先级队列);scripts/validate-queues.sh <project-dir>,检查任务装饰器队列有效、无硬编码队列名、队列定义完整、优先级 0-255 合法、交换机类型匹配、worker 配置引用有效队列。提供模板:基础队列配置(CELERY_QUEUES/CELERY_ROUTES)、动态路由规则、优先级队列(x-max-priority)、主题交换(* 与 # 通配符)、工作进程专属路由(CPU 密集与 I/O 密集分离)。示例涵盖优先级队列配置、主题路由实现、worker 队列分配策略。
使用方式:导入模板中的 CELERY_ROUTES 与 CELERY_QUEUES 并赋给 app.conf.task_routes 和 task_queues;动态路由使用 route_task(name, args, kwargs, options, task, **kw) 函数;启动工作进程如 celery -A myapp worker -Q ml_training,video_processing -c 4 -n cpu@%h;通过 BROKER_URL 等环境变量配置 broker,代码示例均用占位值。
适用场景与限制:适合按优先级、任务类型或资源特性分发任务(如 CPU 密集、I/O 密集、邮件、报表、通知)。RabbitMQ 原生支持优先级,Redis 需通过独立队列模拟,效率较低;优先级检查有额外开销,应谨慎使用。配置全部需以环境变量提供,示例使用占位凭据。依赖 Celery 5.0+、RabbitMQ 3.8+ 或 Redis 6.0+、Python 3.8+、kombu;RabbitMQ 优先级队列需 3.5+;测试脚本需 netcat/telnet。其余细节暂未提供。