fastapi 0.162.7 版本修复了异步 yield 依赖在请求被客户端取消时清理代码无法执行的问题。要确保资源正确释放,必须使用标准的 async with 上下文管理器模式或确保生成器在异常退出时能触发清理逻辑,fastapi 内部现在会正确处理 cancellederror 以调用 yield 后的代码。

旧版本中请求取消导致清理失败的原因
在 FastAPI 早期版本中,当客户端断开连接(如关闭浏览器标签页)时,Starlette 会抛出 CancelledError。如果依赖项的生成器正在等待数据库查询或网络 I/O,这个异常会直接中断生成器,导致 yield 之后的清理代码(如关闭数据库连接、释放锁)永远不会被执行。这是因为 Python 的生成器在没有显式捕获异常的情况下,遇到未处理的异常会直接终止,而不会自动运行后续的清理语句。

from fastapi import FastAPI, Depends
import asyncio
app = FastAPI()
class Database:
def __init__(self):
self.connected = False
async def connect(self):
print("Connecting...")
await asyncio.sleep(1)
self.connected = True
async def close(self):
print("Closing connection!")
self.connected = False
async def get_db():
db = Database()
await db.connect()
try:
yield db
finally:
# 在旧版本中,如果客户端取消请求,这里可能不会被执行
await db.close()
@app.get("/slow")
async def slow_endpoint(db: Database = Depends(get_db)):
await asyncio.sleep(5) # 模拟长耗时操作
return {"status": "ok"}
在上述代码中,如果客户端在 await asyncio.sleep(5) 期间取消请求,finally 块中的 db.close() 在某些实现细节下可能因异常传播路径问题而被跳过,导致连接泄漏。
新版本中如何验证清理逻辑已生效
在 FastAPI 0.162.7 及更新版本中,框架对依赖项的生命周期管理进行了优化,确保即使发生 CancelledError,清理代码也能得到执行。我们可以通过一个简单的测试脚本来验证这一点:启动服务器后,使用 curl 发送一个请求并立即中断它,观察服务端日志是否打印出清理信息。

import subprocess
import time
import signal
# 假设上面的代码保存在 main.py 中
process = subprocess.Popen(["uvicorn", "main:app", "--host", "127.0.0.1", "--port", "8000"])
time.sleep(2) # 等待服务器启动
# 发送请求并立即取消
proc = subprocess.Popen(["curl", "http://127.0.0.1:8000/slow"], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
time.sleep(0.5) # 让请求开始处理
proc.kill() # 强制取消请求
stdout, stderr = proc.communicate()
# 等待一段时间让服务器处理清理逻辑
time.sleep(2)
# 检查服务器进程是否还在运行,以及日志输出
print("Server process PID:", process.pid)
process.terminate()
process.wait()
运行上述脚本后,查看 Uvicorn 服务器的标准输出。如果看到 “Closing connection!” 的日志打印出来,说明清理逻辑已经成功执行。这证明了 FastAPI 在新版本中能够正确处理请求取消时的依赖项清理。
基于 yield 依赖中数据库连接池的具体清理行为
在实际应用中,最常见的 yield 依赖是数据库会话或连接池的管理。在 FastAPI 0.162.7 中,如果使用 SQLAlchemy 的 Session 作为依赖项,当请求被取消时,框架会确保 session.close() 被调用,从而将连接返回给连接池。这一行为对于防止连接池耗尽至关重要。开发者无需手动捕获 CancelledError 来触发清理,只需保证 yield 后的代码是同步可执行的清理逻辑即可。例如,在 get_session 依赖中,yield 之后直接调用 session.close() 即可,FastAPI 会保证该语句在请求结束(无论是正常结束还是被取消)时执行。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











