Flask下如何向Celery任务传递参数？参数数量不匹配报错处理

1 优先排查：Celery Worker进程未重启 #

这是该类报错最常见的诱因：你修改任务函数新增file_list参数后，仅重启了Flask应用进程，但负责执行异步任务的Celery Worker进程仍在运行旧版本的代码。如果旧版本的long_task仅定义了self一个参数，就会在收到self+你传入的file_list两个参数时，抛出参数数量不匹配的错误。
解决方法：终止所有运行中的Celery Worker进程，重新启动Worker，确保加载的是最新代码。

2 确认参数传递写法规范 #

你当前的传参写法是正确的：
bind=True装饰的任务，第一个参数固定为任务实例self，使用args=[file_list]传递后续参数的写法完全符合Celery规范，也可以替换为更简洁的delay写法：

task = long_task.delay(file_list)

两种写法的执行逻辑完全一致，不存在兼容性问题。

3 排查装饰器叠加冲突 #

如果long_task上除了@celery.task外还叠加了其他装饰器，需要确保@celery.task放在所有装饰器的最外层，否则会导致Celery解析函数参数时出现异常。

4 排查同名任务冲突 #

如果项目中存在多个同名的long_task函数定义，Celery可能加载了错误的任务定义导致参数不匹配。你可以给任务显式指定唯一名称避免冲突：

@celery.task(bind=True, name="your_custom_namespace.long_task")
def long_task(self, file_list):
    # 原有任务逻辑

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