FastAPI异步yield依赖在请求取消时的清理:0.162.7修复核对

星雪吖_7686

星雪吖_7686

2026-11-17

108人浏览

原创

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

FastAPI异步yield依赖在请求取消时的清理:0.162.7修复核对

旧版本中请求取消导致清理失败的原因

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

FastAPI异步yield依赖在请求取消时的清理:0.162.7修复核对

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 发送一个请求并立即中断它,观察服务端日志是否打印出清理信息。

fastapi-pro
fastapi-pro

使用 FastAPI、SQLAlchemy 2.0 和 Pydantic V2 构建高性能异步 API。精通微服务、WebSocket 和现代 Python 异

下载

FastAPI异步yield依赖在请求取消时的清理:0.162.7修复核对

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应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

fastapi

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1931

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5504

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

33537

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3927

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3947

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1283

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3063

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程