FastAPI：路由函数外使用BackgroundTasks为何表现不同？

案例1：官方标准示例（正常运行） #

@app.get('/')
async def index(background_tasks: BackgroundTasks):
    background_tasks.add_task(some_function_reference)
    #Executes non-blocking in the same asyncio loop without any issues
    return "Hello"

这个案例能正常运行的核心是依赖注入机制：FastAPI会自动为路由处理器函数（被@app.get装饰的函数）创建并注入一个和当前请求绑定的BackgroundTasks实例。当路由返回响应后，FastAPI会自动触发这个实例中所有已添加的后台任务，确保它们在请求上下文里执行。

案例2：路由外函数使用BackgroundTasks（报错） #

async def some_logic(background_tasks: BackgroundTasks):
    #Throws a "required positional argument missing" error
    background_tasks.add_task(some_function_reference)


@app.get('/')
async def index():
    await some_logic()
    #Executes non-blocking in the same asyncio loop
    return "Hello"

报错的原因很直接：FastAPI的依赖注入仅作用于路由处理器函数，普通函数（比如some_logic）不会自动触发注入。调用some_logic()时没有手动传入background_tasks参数，自然会抛出“缺少位置参数”的错误。

案例3：路由外初始化BackgroundTasks（任务不执行） #

async def some_logic():
    #Does not Run
    background_tasks = BackgroundTasks()
    background_tasks.add_task(some_function_reference)


@app.get('/')
async def index(background_tasks: BackgroundTasks):
    await some_logic()
    #Executes non-blocking in the same asyncio loop
    return "Hello"

这里自己创建的BackgroundTasks是一个局部独立实例，FastAPI完全不知道它的存在。只有FastAPI通过依赖注入生成的、与当前请求绑定的BackgroundTasks实例，才会被框架跟踪，并在请求处理完成后执行其中的任务。你手动创建的实例没有被FastAPI注册到请求生命周期中，所以添加的任务永远不会被触发。

为什么必须从路由函数传递BackgroundTasks实例？ #

因为只有FastAPI注入的BackgroundTasks实例是和当前请求的生命周期绑定的，框架会在请求响应返回后自动处理这个实例里的任务。如果你自己创建实例，或者不传递注入的实例，FastAPI无法识别这些任务，自然不会执行它们。传递实例本质上是让后续函数复用同一个和请求绑定的任务容器，确保任务能被框架调度执行。

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