0

0

Python gc.get_referrers() 如何用来排查内存泄漏源头

冰川箭仙

冰川箭仙

发布时间:2026-01-23 18:27:09

|

726人浏览过

|

来源于php中文网

原创

gc.get_referrers() 能定位泄漏对象的持有者,因为它反向查询当前直接引用该对象的所有对象,从而揭示意外的引用链;它只返回垃圾回收器管理的非原子类型对象的直接引用者,需配合 gc.collect() 和去重使用,并注意性能与误判风险。

python gc.get_referrers() 如何用来排查内存泄漏源头

为什么 gc.get_referrers() 能定位泄漏对象的持有者

Python 的内存泄漏往往不是对象没被销毁,而是它被某个“意外的引用链”死死拽住。gc.get_referrers() 不查对象自己做了什么,而是反向查——谁正指着它。只要泄漏对象还活着,就一定有至少一个 referrer(比如全局变量、类属性、闭包、容器等)在持有它。这是最直接的“逆向追踪”手段。

注意:它只返回当前可达的直接引用者(不递归),且要求目标对象在垃圾回收器管理范围内(即非原子类型,如 list/dict/自定义类实例等)。对 int、str 等小常量或 C 扩展对象可能为空或不可靠。

怎么用 gc.get_referrers() 锁定可疑引用链

典型流程是“抓活口 → 查引用 → 溯源头”。先通过 gc.get_objects() 或第三方工具(如 objgraph)找出疑似泄漏的长生命周期对象(比如不断增长的 list 实例或自定义类实例),再对其调用 gc.get_referrers()

  • 确保已启用垃圾回收:gc.enable()(默认开启,但显式确认更稳)
  • 避免干扰:调用前手动触发一次 gc.collect(),清理掉本该被回收的临时对象
  • 聚焦目标:不要对所有对象调用,只对 id(obj) 已知、且你怀疑“不该存在这么久”的对象查
  • 结果去重:返回列表常含重复项(如多个 dict 引用同一对象),建议用 list(set(...)) 初筛

示例:

Vozo
Vozo

Vozo是一款强大的AI视频编辑工具,可以帮助用户轻松重写、配音和编辑视频。

下载

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

import gc
# 假设 obj 是你从 objgraph.find_backref_chain() 或内存快照中锁定的可疑对象
referrers = gc.get_referrers(obj)
for r in referrers[:3]:  # 只看前几个,避免刷屏
    print(type(r), getattr(r, '__name__', ''), getattr(r, '__class__', ''))

常见 referrer 类型及对应排查方向

返回的 referrer 类型直接暴露泄漏入口点。重点盯以下几类:

  • dict:检查是否误塞进全局字典、模块级缓存、__dict__ 或日志上下文;特别注意 locals() 或装饰器闭包里偷偷保留的引用
  • list / tuple:查是否作为全局队列、待处理缓冲区、事件监听器列表未及时 pop/clear
  • 自定义类实例:看其属性名(r.__dict__.keys()),比如 self._cacheself._handlers 是否累积未清理
  • functionmethod:说明是闭包或绑定方法持有了对象,需 inspect 其 __closure____func__.__globals__
  • module:最危险——说明对象被挂到了模块顶层,比如 my_module.GLOBAL_LIST.append(obj) 后忘记清理

容易踩的坑和性能注意点

gc.get_referrers() 看似简单,但实战中几个细节常导致误判或卡死:

  • 别在生产环境高频调用:它会遍历整个堆内存查找引用,对象多时极慢,甚至引发明显延迟
  • 别信第一个 referrer:返回顺序无保证,首个可能是无关的临时引用(如函数参数帧),要结合类型 + 属性综合判断
  • 循环引用场景下,gc.get_referrers() 可能返回 GC 自身的跟踪结构(如 gc.garbage),需过滤掉 type(r) is list and len(r) > 1000 这类异常大列表
  • 多线程下结果可能瞬时失效:引用关系在调用瞬间存在,但下一毫秒就被释放了。务必在稳定复现泄漏的步骤后立即捕获

真正难的不是找到 referrer,而是判断“这个引用是否合理”——比如一个 dict 引用泄漏对象,得立刻查清它是配置缓存、还是本该随请求结束就丢弃的上下文残留。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1564

2023.10.24

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1564

2023.10.24

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

93

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

106

2025.09.18

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1010

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

607

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

314

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

235

2025.08.29

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

4

2026.03.10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号