讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

怎样在Python中排查FastAPI服务的内存泄漏问题

千磊姑娘_6015

千磊姑娘_6015

发布时间:2026-11-19 09:45:20

|

963人浏览过

|

来源于php中文网

原创

tracemalloc可快速定位内存增长源头,通过启动时调用tracemalloc.start()、暴露/debug/memory端点获取调用栈统计,结合objgraph分析对象类型与引用链,精准识别未释放对象所在行及持有者。

怎样在python中排查fastapi服务的内存泄漏问题

用 tracemalloc 快速定位内存增长源头

FastAPI 本身不直接导致内存泄漏,但异步逻辑、全局缓存、未关闭的资源(如数据库连接、文件句柄)或第三方库误用容易让对象长期驻留内存。最轻量且有效的初筛手段是启用 tracemalloc,它能在运行时记录内存分配的调用栈。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 在应用启动前(如 main.py 最顶部)插入:
    import tracemalloc<br>tracemalloc.start(25)  # 保存最多25层调用栈
  • 暴露一个调试端点(仅限开发/测试环境),例如:
    @app.get("/debug/memory")<br>async def get_memory():<br>    current, peak = tracemalloc.get_traced_memory()<br>    snapshot = tracemalloc.take_snapshot().filter_traces(<br>        [tracemalloc.Filter(True, "*main.py"), tracemalloc.Filter(True, "*routes/*.py")]<br>    )<br>    top_stats = snapshot.statistics("lineno")[:10]<br>    return {"current_kb": current / 1024, "peak_kb": peak / 1024, "top": [str(s) for s in top_stats]}
  • 持续压测后访问 /debug/memory,重点关注 line number 和增长快的 size —— 很可能就是反复创建却未释放的对象所在行

检查 BackgroundTasks 和生命周期管理不当的依赖

FastAPI 的 BackgroundTasks 是常见泄漏温床:任务函数中若持有大对象引用、使用闭包捕获了请求上下文(如 request.state)、或内部启用了未清理的 asyncio 任务(如 asyncio.create_task() 无 await 或 cancel),都会阻止垃圾回收。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 避免在 BackgroundTasks 中直接引用 request 或 state;改用显式传参(只传必要字段)
  • 检查所有自定义依赖(Depends())是否实现了 __exit__ 或 async def __aexit__,尤其涉及数据库连接池、HTTP 客户端(如 httpx.AsyncClient)、或缓存实例
  • 确认 lifespan 事件中正确关闭了全局资源,例如:
    async def lifespan(app: FastAPI):<br>    # 启动时<br>    app.state.client = httpx.AsyncClient()<br>    yield<br>    # 关闭时必须显式调用<br>    await app.state.client.aclose()

警惕 asyncpg、aiomysql 等异步驱动的连接泄漏

这类驱动默认使用连接池,但若在请求中手动调用 pool.acquire() 却忘记 pool.release(),或在异常路径下跳过了释放逻辑,连接对象会持续累积,最终耗尽内存和连接数。

Python健壮编程
Python健壮编程

编写可靠Python代码,避免可变默认值、导入陷阱与运行时意外

下载

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 永远用 async with pool.acquire() as conn:,而不是裸调用 acquire()
  • 检查所有 try/except 块:确保 finally 或 async with 覆盖所有退出路径
  • 开启驱动日志验证行为,例如 asyncpg:
    import logging<br>logging.getLogger("asyncpg").setLevel(logging.WARNING)
    —— 若出现 connection pool is full 或大量 Connection closed 日志,基本可判定泄漏已发生

用 objgraph 查看存活对象类型分布

当 tracemalloc 显示某模块内存持续上涨,但找不到具体变量时,objgraph 可以列出当前存活对象的类型统计,并对比两次快照找出新增最多的类,这对识别“谁在偷偷 hold 住对象”非常关键。

实操建议:

立即学习“Python免费学习笔记(深入)”;

  • 安装并初始化:
    pip install objgraph<br>import objgraph
  • 在怀疑泄漏前后各执行一次:
    objgraph.show_most_common_types(limit=20)
    ,对比哪些类实例数激增(如 dict、list、Request、自定义 Model 类)
  • 对激增类做引用链追踪:
    objgraph.show_growth(limit=10)  # 显示新增数量最多的类型<br># 找到某个可疑实例 ID 后:<br>objgraph.show_backrefs([obj], max_depth=3)
    —— 这能暴露是谁在引用它,常发现是全局字典、未清空的缓存或 event loop 的 pending task

内存泄漏排查没有银弹,tracemalloc 给位置,objgraph 给关系,而真正修复往往卡在「那个本该被 await 却漏掉的 aclose()」或者「以为自动回收其实被闭包锁死的 request 对象」—— 多打几次快照,比猜更可靠。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

1951

2023.07.20

python能做什么
python能做什么

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

5564

2023.07.25

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

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

1889

2023.07.31

python教程
python教程

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

33997

2023.08.03

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

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

3987

2023.08.04

python eval
python eval

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

3987

2023.08.04

scratch和python区别
scratch和python区别

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

1283

2023.08.11

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

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

636

2023.08.10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn