使用GC、Objgraph干掉Python內(nèi)存泄露與循環(huán)引用!
Python使用引用計數(shù)和垃圾回收來做內(nèi)存管理,前面也寫過一遍文章《Python內(nèi)存優(yōu)化》,介紹了在python中,如何profile內(nèi)存使用情況,并做出相應的優(yōu)化。本文介紹兩個更致命的問題:內(nèi)存泄露與循環(huán)引用。內(nèi)存泄露是讓所有程序員都聞風喪膽的問題,輕則導致程序運行速度減慢,重則導致程序崩潰;而循環(huán)引用是使用了引用計數(shù)的數(shù)據(jù)結(jié)構(gòu)、編程語言都需要解決的問題。本文揭曉這兩個問題在python語言中是如何存在的,然后試圖利用gc模塊和objgraph來解決這兩個問題。
注意:本文的目標是Cpython,測試代碼都是運行在Python2.7。另外,本文不考慮C擴展造成的內(nèi)存泄露,這是另一個復雜且頭疼的問題。
一分鐘版本
- python使用引用計數(shù)和垃圾回收來釋放(free)Python對象
- 引用計數(shù)的優(yōu)點是原理簡單、將消耗均攤到運行時;缺點是無法處理循環(huán)引用
- Python垃圾回收用于處理循環(huán)引用,但是無法處理循環(huán)引用中的對象定義了__del__的情況,而且每次回收會造成一定的卡頓
- gc module是python垃圾回收機制的接口模塊,可以通過該module啟停垃圾回收、調(diào)整回收觸發(fā)的閾值、設置調(diào)試選項
- 如果沒有禁用垃圾回收,那么Python中的內(nèi)存泄露有兩種情況:要么是對象被生命周期更長的對象所引用,比如global作用域?qū)ο?要么是循環(huán)引用中存在__del__
- 使用gc module、objgraph可以定位內(nèi)存泄露,定位之后,解決很簡單
- 垃圾回收比較耗時,因此在對性能和內(nèi)存比較敏感的場景也是無法接受的,如果能解除循環(huán)引用,就可以禁用垃圾回收。
- 使用gc module的DEBUG選項可以很方便的定位循環(huán)引用,解除循環(huán)引用的辦法要么是手動解除,要么是使用weakref
python內(nèi)存管理
Python中,一切都是對象,又分為mutable和immutable對象。二者區(qū)分的標準在于是否可以原地修改,“原地“”可以理解為相同的地址??梢酝ㄟ^id()查看一個對象的“地址”,如果通過變量修改對象的值,但id沒發(fā)生變化,那么就是mutable,否則就是immutable。比如:
- >>> a = 5;id(a)
- 35170056
- >>> a = 6;id(a)
- 35170044
- >>> lst = [1,2,3]; id(lst)
- 39117168
- >>> lst.append(4); id(lst)
- 39117168
a指向的對象(int類型)就是immutable, 賦值語句只是讓變量a指向了一個新的對象,因為id發(fā)生了變化。而lst指向的對象(list類型)為可變對象,通過方法(append)可以修改對象的值,同時保證id一致。
判斷兩個變量是否相等(值相同)使用==, 而判斷兩個變量是否指向同一個對象使用 is。比如下面a1 a2這兩個變量指向的都是空的列表,值相同,但是不是同一個對象。
- >>> a1, a2 = [], []
- >>> a1 == a2
- True
- >>> a1 is a2
- False
為了避免頻繁的申請、釋放內(nèi)存,避免大量使用的小對象的構(gòu)造析構(gòu),python有一套自己的內(nèi)存管理機制。在巨著《Python源碼剖析》中有詳細介紹,在python源碼obmalloc.h中也有詳細的描述。如下所示:
可以看到,python會有自己的內(nèi)存緩沖池(layer2)以及對象緩沖池(layer3)。在Linux上運行過Python服務器的程序都知道,python不會立即將釋放的內(nèi)存歸還給操作系統(tǒng),這就是內(nèi)存緩沖池的原因。而對于可能被經(jīng)常使用、而且是immutable的對象,比如較小的整數(shù)、長度較短的字符串,python會緩存在layer3,避免頻繁創(chuàng)建和銷毀。例如:
- >>> a, b = 1, 1
- >>> a is b
- True
- >>> a, b = (), ()
- >>> a is b
- True
- >>> a, b = {}, {}
- >>> a is b
- False
本文并不關(guān)心python是如何管理內(nèi)存塊、如何管理小對象,感興趣的讀者可以參考伯樂在線和csdn上的這兩篇文章。
本文關(guān)心的是,一個普通的對象的生命周期,更明確的說,對象是什么時候被釋放的。當一個對象理論上(或者邏輯上)不再被使用了,但事實上沒有被釋放,那么就存在內(nèi)存泄露;當一個對象事實上已經(jīng)不可達(unreachable),即不能通過任何變量找到這個對象,但這個對象沒有立即被釋放,那么則可能存在循環(huán)引用。
引用計數(shù)
引用計數(shù)(References count),指的是每個Python對象都有一個計數(shù)器,記錄著當前有多少個變量指向這個對象。
將一個對象直接或者間接賦值給一個變量時,對象的計數(shù)器會加1;當變量被del刪除,或者離開變量所在作用域時,對象的引用計數(shù)器會減1。當計數(shù)器歸零的時候,代表這個對象再也沒有地方可能使用了,因此可以將對象安全的銷毀。Python源碼中,通過Py_INCREF和Py_DECREF兩個宏來管理對象的引用計數(shù),代碼在object.h
- #define Py_INCREF(op) ( \
- _Py_INC_REFTOTAL _Py_REF_DEBUG_COMMA \
- ((PyObject*)(op))->ob_refcnt++)
- #define Py_DECREF(op) \
- do { \
- if (_Py_DEC_REFTOTAL _Py_REF_DEBUG_COMMA \
- --((PyObject*)(op))->ob_refcnt != 0) \
- _Py_CHECK_REFCNT(op) \
- else \
- _Py_Dealloc((PyObject *)(op)); \
- } while (0)
通過sys.getrefcount(obj)對象可以獲得一個對象的引用數(shù)目,返回值是真實引用數(shù)目加1(加1的原因是obj被當做參數(shù)傳入了getrefcount函數(shù)),例如:
- >>> import sys
- >>> s = 'asdf'
- >>> sys.getrefcount(s)
- 2
- >>> a = 1
- >>> sys.getrefcount(a)
- 605
從對象1的引用計數(shù)信息也可以看到,python的對象緩沖池會緩存十分常用的immutable對象,比如這里的整數(shù)1。
引用計數(shù)的優(yōu)點在于原理通俗易懂;且將對象的回收分布在代碼運行時:一旦對象不再被引用,就會被釋放掉(be freed),不會造成卡頓。但也有缺點:額外的字段(ob_refcnt);頻繁的加減ob_refcnt,而且可能造成連鎖反應。但這些缺點跟循環(huán)引用比起來都不算事兒。
什么是循環(huán)引用,就是一個對象直接或者間接引用自己本身,引用鏈形成一個環(huán)。且看下面的例子:
- # -*- coding: utf-8 -*-
- import objgraph, sys
- class OBJ(object):
- pass
- def show_direct_cycle_reference():
- a = OBJ()
- a.attr = a
- objgraph.show_backrefs(a, max_depth=5, filename = "direct.dot")
- def show_indirect_cycle_reference():
- a, b = OBJ(), OBJ()
- a.attr_b = b
- b.attr_a = a
- objgraph.show_backrefs(a, max_depth=5, filename = "indirect.dot")
- if __name__ == '__main__':
- if len(sys.argv) > 1:
- show_direct_cycle_reference()
- else:
- show_indirect_cycle_reference()
運行上面的代碼,使用graphviz工具集(本文使用的是dotty)打開生成的兩個文件,direct.dot 和 indirect.dot,得到下面兩個圖
通過屬性名(attr, attr_a, attr_b)可以很清晰的看出循環(huán)引用是怎么產(chǎn)生的
前面已經(jīng)提到,對于一個對象,當沒有任何變量指向自己時,引用計數(shù)降到0,就會被釋放掉。我們以上面左邊那個圖為例,可以看到,紅框里面的OBJ對象想在有兩個引用(兩個入度),分別來自幀對象frame(代碼中,函數(shù)局部空間持有對OBJ實例的引用)、attr變量。我們再改一下代碼,在函數(shù)運行技術(shù)之后看看是否還有OBJ類的實例存在,引用關(guān)系是怎么樣的:
- # -*- coding: utf-8 -*-
- import objgraph, sys
- class OBJ(object):
- pass
- def direct_cycle_reference():
- a = OBJ()
- a.attr = a
- if __name__ == '__main__':
- direct_cycle_reference()
- objgraph.show_backrefs(objgraph.by_type('OBJ')[0], max_depth=5, filename = "direct.dot"
修改后的代碼,OBJ實例(a)存在于函數(shù)的local作用域。因此,當函數(shù)調(diào)用結(jié)束之后,來自幀對象frame的引用被解除。從圖中可以看到,當前對象的計數(shù)器(入度)為1,按照引用計數(shù)的原理,是不應該被釋放的,但這個對象在函數(shù)調(diào)用結(jié)束之后就是事實上的垃圾,這個時候就需要另外的機制來處理這種情況了。
python的世界,很容易就會出現(xiàn)循環(huán)引用,比如標準庫Collections中OrderedDict的實現(xiàn)(已去掉無關(guān)注釋):
- class OrderedDict(dict):
- def __init__(self, *args, **kwds):
- if len(args) > 1:
- raise TypeError('expected at most 1 arguments, got %d' % len(args))
- try:
- self.__root
- except AttributeError:
- self.__root = root = [] # sentinel node
- root[:] = [root, root, None]
- self.__map = {}
- self.__update(*args, **kwds)
注意第8、9行,root是一個列表,列表里面的元素之自己本身!
垃圾回收
這里強調(diào)一下,本文中的的垃圾回收是狹義的垃圾回收,是指當出現(xiàn)循環(huán)引用,引用計數(shù)無計可施的時候采取的垃圾清理算法。
在python中,使用標記-清除算法(mark-sweep)和分代(generational)算法來垃圾回收。在《Garbage Collection for Python》一文中有對標記回收算法,然后在《Python內(nèi)存管理機制及優(yōu)化簡析》一文中,有對前文的翻譯,并且有分代回收的介紹。在這里,引用后面一篇文章:
在Python中, 所有能夠引用其他對象的對象都被稱為容器(container). 因此只有容器之間才可能形成循環(huán)引用. Python的垃圾回收機制利用了這個特點來尋找需要被釋放的對象. 為了記錄下所有的容器對象, Python將每一個 容器都鏈到了一個雙向鏈表中, 之所以使用雙向鏈表是為了方便快速的在容器集合中插入和刪除對象. 有了這個 維護了所有容器對象的雙向鏈表以后, Python在垃圾回收時使用如下步驟來尋找需要釋放的對象:
- 對于每一個容器對象, 設置一個gc_refs值, 并將其初始化為該對象的引用計數(shù)值.
- 對于每一個容器對象, 找到所有其引用的對象, 將被引用對象的gc_refs值減1.
- 執(zhí)行完步驟2以后所有g(shù)c_refs值還大于0的對象都被非容器對象引用著, 至少存在一個非循環(huán)引用. 因此 不能釋放這些對象, 將他們放入另一個集合.
- 在步驟3中不能被釋放的對象, 如果他們引用著某個對象, 被引用的對象也是不能被釋放的, 因此將這些 對象也放入另一個集合中.
- 此時還剩下的對象都是無法到達的對象. 現(xiàn)在可以釋放這些對象了.
關(guān)于分代回收:
除此之外, Python還將所有對象根據(jù)’生存時間’分為3代, 從0到2. 所有新創(chuàng)建的對象都分配為第0代. 當這些對象 經(jīng)過一次垃圾回收仍然存在則會被放入第1代中. 如果第1代中的對象在一次垃圾回收之后仍然存貨則被放入第2代. 對于不同代的對象Python的回收的頻率也不一樣. 可以通過gc.set_threshold(threshold0[, threshold1[, threshold2]]) 來定義. 當Python的垃圾回收器中新增的對象數(shù)量減去刪除的對象數(shù)量大于threshold0時, Python會對第0代對象 執(zhí)行一次垃圾回收. 每當?shù)?代被檢查的次數(shù)超過了threshold1時, 第1代對象就會被執(zhí)行一次垃圾回收. 同理每當 第1代被檢查的次數(shù)超過了threshold2時, 第2代對象也會被執(zhí)行一次垃圾回收.
注意,threshold0,threshold1,threshold2的意義并不相同!
為什么要分代呢,這個算法的根源來自于weak generational hypothesis。這個假說由兩個觀點構(gòu)成:首先是年親的對象通常死得也快,比如大量的對象都存在于local作用域;而老對象則很有可能存活更長的時間,比如全局對象,module, class。
垃圾回收的原理就如上面提示,詳細的可以看Python源碼,只不過事實上垃圾回收器還要考慮__del__,弱引用等情況,會略微復雜一些。
什么時候會觸發(fā)垃圾回收呢,有三種情況:
- 達到了垃圾回收的閾值,Python虛擬機自動執(zhí)行
- 手動調(diào)用gc.collect()
- Python虛擬機退出的時候
對于垃圾回收,有兩個非常重要的術(shù)語,那就是reachable與collectable(當然還有與之對應的unreachable與uncollectable),后文也會大量提及。
reachable是針對python對象而言,如果從根集(root)能到找到對象,那么這個對象就是reachable,與之相反就是unreachable,事實上就是只存在于循環(huán)引用中的對象,Python的垃圾回收就是針對unreachable對象。
而collectable是針對unreachable對象而言,如果這種對象能被回收,那么是collectable;如果不能被回收,即循環(huán)引用中的對象定義了__del__, 那么就是uncollectable。Python垃圾回收對uncollectable對象無能為力,會造成事實上的內(nèi)存泄露。
gc module
這里的gc(garbage collector)是Python 標準庫,該module提供了與上一節(jié)“垃圾回收”內(nèi)容相對應的接口。通過這個module,可以開關(guān)gc、調(diào)整垃圾回收的頻率、輸出調(diào)試信息。gc模塊是很多其他模塊(比如objgraph)封裝的基礎(chǔ),在這里先介紹gc的核心API。
- gc.enable(); gc.disable(); gc.isenabled()
開啟gc(默認情況下是開啟的);關(guān)閉gc;判斷gc是否開啟
- gc.collection()
執(zhí)行一次垃圾回收,不管gc是否處于開啟狀態(tài)都能使用
- gc.set_threshold(t0, t1, t2); gc.get_threshold()
設置垃圾回收閾值; 獲得當前的垃圾回收閾值
注意:gc.set_threshold(0)也有禁用gc的效果
- gc.get_objects()
返回所有被垃圾回收器(collector)管理的對象。這個函數(shù)非?;A(chǔ)!只要python解釋器運行起來,就有大量的對象被collector管理,因此,該函數(shù)的調(diào)用比較耗時!
比如,命令行啟動python
- >>> import gc
- >>> len(gc.get_objects())
- 3749
- gc.get_referents(*obj)
返回obj對象直接指向的對象
- gc.get_referrers(*obj)
返回所有直接指向obj的對象
下面的實例展示了get_referents與get_referrers兩個函數(shù)
- >>> class OBJ(object):
- ... pass
- ...
- >>> a, b = OBJ(), OBJ()
- >>> hex(id(a)), hex(id(b))
- ('0x250e730', '0x250e7f0')
- >>> gc.get_referents(a)
- [<class '__main__.OBJ'>]
- >>> a.attr = b
- >>> gc.get_referents(a)
- [{'attr': <__main__.OBJ object at 0x0250E7F0>}, <class '__main__.OBJ'>]
- >>> gc.get_referrers(b)
- [{'attr': <__main__.OBJ object at 0x0250E7F0>}, {'a': <__main__.OBJ object at 0x0250E730>, 'b': <__main__.OBJ object at 0x0250E7F0>, 'OBJ': <class '__main__.OBJ'>, '__builtins__': <modu
- le '__builtin__' (built-in)>, '__package__': None, 'gc': <module 'gc' (built-in)>, '__name__': '__main__', '__doc__': None}]
- >>>
a, b都是類OBJ的實例,執(zhí)行”a.attr = b”之后,a就通過‘’attr“這個屬性指向了b。
- gc.set_debug(flags)
設置調(diào)試選項,非常有用,常用的flag組合包含以下
gc.DEBUG_COLLETABLE: 打印可以被垃圾回收器回收的對象
gc.DEBUG_UNCOLLETABLE: 打印無法被垃圾回收器回收的對象,即定義了__del__的對象
gc.DEBUG_SAVEALL:當設置了這個選項,可以被拉起回收的對象不會被真正銷毀(free),而是放到gc.garbage這個列表里面,利于在線上查找問題
內(nèi)存泄露
既然Python中通過引用計數(shù)和垃圾回收來管理內(nèi)存,那么什么情況下還會產(chǎn)生內(nèi)存泄露呢?有兩種情況:
第一是對象被另一個生命周期特別長的對象所引用,比如網(wǎng)絡服務器,可能存在一個全局的單例ConnectionManager,管理所有的連接Connection,如果當Connection理論上不再被使用的時候,沒有從ConnectionManager中刪除,那么就造成了內(nèi)存泄露。
第二是循環(huán)引用中的對象定義了__del__函數(shù),這個在《程序員必知的Python陷阱與缺陷列表》一文中有詳細介紹,簡而言之,如果定義了__del__函數(shù),那么在循環(huán)引用中Python解釋器無法判斷析構(gòu)對象的順序,因此就不錯處理。
在任何環(huán)境,不管是服務器,客戶端,內(nèi)存泄露都是非常嚴重的事情。
如果是線上服務器,那么一定得有監(jiān)控,如果發(fā)現(xiàn)內(nèi)存使用率超過設置的閾值則立即報警,盡早發(fā)現(xiàn)些許還有救。當然,誰也不希望在線上修復內(nèi)存泄露,這無疑是給行駛的汽車換輪子,因此盡量在開發(fā)環(huán)境或者壓力測試環(huán)境發(fā)現(xiàn)并解決潛在的內(nèi)存泄露。在這里,發(fā)現(xiàn)問題最為關(guān)鍵,只要發(fā)現(xiàn)了問題,解決問題就非常容易了,因為按照前面的說法,出現(xiàn)內(nèi)存泄露只有兩種情況,在第一種情況下,只要在適當?shù)臅r機解除引用就可以了;在第二種情況下,要么不再使用__del__函數(shù),換一種實現(xiàn)方式,要么解決循環(huán)引用。
那么怎么查找哪里存在內(nèi)存泄露呢?武器就是兩個庫:gc、objgraph
在上面已經(jīng)介紹了gc這個模塊,理論上,通過gc模塊能夠拿到所有的被garbage collector管理的對象,也能知道對象之間的引用和被引用關(guān)系,就可以畫出對象之間完整的引用關(guān)系圖。但事實上還是比較復雜的,因為在這個過程中一不小心又會引入新的引用關(guān)系,所以,有好的輪子就直接用吧,那就是objgraph。
objgraph
objgraph的實現(xiàn)調(diào)用了gc的這幾個函數(shù):gc.get_objects(), gc.get_referents(), gc.get_referers(),然后構(gòu)造出對象之間的引用關(guān)系。objgraph的代碼和文檔都寫得比較好,建議一讀。
下面先介紹幾個十分實用的API
- def count(typename)
返回該類型對象的數(shù)目,其實就是通過gc.get_objects()拿到所用的對象,然后統(tǒng)計指定類型的數(shù)目。
- def by_type(typename)
返回該類型的對象列表。線上項目,可以用這個函數(shù)很方便找到一個單例對象
- def show_most_common_types(limits = 10)
打印實例最多的前N(limits)個對象,這個函數(shù)非常有用。在《Python內(nèi)存優(yōu)化》一文中也提到,該函數(shù)能發(fā)現(xiàn)可以用slots進行內(nèi)存優(yōu)化的對象
- def show_growth()
統(tǒng)計自上次調(diào)用以來增加得最多的對象,這個函數(shù)非常有利于發(fā)現(xiàn)潛在的內(nèi)存泄露。函數(shù)內(nèi)部調(diào)用了gc.collect(),因此即使有循環(huán)引用也不會對判斷造成影響。
值得一提,該函數(shù)的實現(xiàn)非常有意思,簡化后的代碼如下:
- def show_growth(limit=10, peak_stats={}, shortnames=True, file=None):
- gc.collect()
- stats = typestats(shortnames=shortnames)
- deltas = {}
- for name, count in iteritems(stats):
- old_count = peak_stats.get(name, 0)
- if count > old_count:
- deltas[name] = count - old_count
- peak_stats[name] = count
- deltas = sorted(deltas.items(), key=operator.itemgetter(1),
- reverse=True)
注意形參peak_stats使用了可變參數(shù)作為默認形參,這樣很方便記錄上一次的運行結(jié)果。在《程序員必知的Python陷阱與缺陷列表》中提到,使用可變對象做默認形參是最為常見的python陷阱,但在這里,卻成為了方便的利器!
- def show_backrefs()
生產(chǎn)一張有關(guān)objs的引用圖,看出看出對象為什么不釋放,后面會利用這個API來查內(nèi)存泄露。
該API有很多有用的參數(shù),比如層數(shù)限制(max_depth)、寬度限制(too_many)、輸出格式控制(filename output)、節(jié)點過濾(filter, extra_ignore),建議使用之間看一些document。
- def find_backref_chain(obj, predicate, max_depth=20, extra_ignore=()):
找到一條指向obj對象的最短路徑,且路徑的頭部節(jié)點需要滿足predicate函數(shù) (返回值為True)
可以快捷、清晰指出 對象的被引用的情況,后面會展示這個函數(shù)的威力
- def show_chain():
將find_backref_chain 找到的路徑畫出來, 該函數(shù)事實上調(diào)用show_backrefs,只是排除了所有不在路徑中的節(jié)點。
查找內(nèi)存泄露
在這一節(jié),介紹如何利用objgraph來查找內(nèi)存是怎么泄露的
如果我們懷疑一段代碼、一個模塊可能會導致內(nèi)存泄露,那么首先調(diào)用一次obj.show_growth(),然后調(diào)用相應的函數(shù),最后再次調(diào)用obj.show_growth(),看看是否有增加的對象。比如下面這個簡單的例子:
- # -*- coding: utf-8 -*-
- import objgraph
- _cache = []
- class OBJ(object):
- pass
- def func_to_leak():
- o = OBJ()
- _cache.append(o)
- # do something with o, then remove it from _cache
- if True: # this seem ugly, but it always exists
- return
- _cache.remove(o)
- if __name__ == '__main__':
- objgraph.show_growth()
- try:
- func_to_leak()
- except:
- pass
- print 'after call func_to_leak'
- objgraph.show_growth()
運行結(jié)果(我們只關(guān)心后一次show_growth的結(jié)果)如下
- wrapper_descriptor 1073 +13
- member_descriptor 204 +5
- getset_descriptor 168 +5
- weakref 338 +3
- dict 458 +3
- OBJ 1 +1
代碼很簡單,函數(shù)開始的時候講對象加入了global作用域的_cache列表,然后期望是在函數(shù)退出之前從_cache刪除,但是由于提前返回或者異常,并沒有執(zhí)行到最后的remove語句。從運行結(jié)果可以發(fā)現(xiàn),調(diào)用函數(shù)之后,增加了一個類OBJ的實例,然而理論上函數(shù)調(diào)用結(jié)束之后,所有在函數(shù)作用域(local)中聲明的對象都改被銷毀,因此這里就存在內(nèi)存泄露。
當然,在實際的項目中,我們也不清楚泄露是在哪段代碼、哪個模塊中發(fā)生的,而且往往是發(fā)生了內(nèi)存泄露之后再去排查,這個時候使用obj.show_most_common_types就比較合適了,如果一個自定義的類的實例數(shù)目特別多,那么就可能存在內(nèi)存泄露。如果在壓力測試環(huán)境,停止壓測,調(diào)用gc.collet,然后再用obj.show_most_common_types查看,如果對象的數(shù)目沒有相應的減少,那么肯定就是存在泄露。
當我們定位了哪個對象發(fā)生了內(nèi)存泄露,那么接下來就是分析怎么泄露的,引用鏈是怎么樣的,這個時候就該show_backrefs出馬了,還是以之前的代碼為例,稍加修改:
- import objgraph
- _cache = []
- class OBJ(object):
- pass
- def func_to_leak():
- o = OBJ()
- _cache.append(o)
- # do something with o, then remove it from _cache
- if True: # this seem ugly, but it always exists
- return
- _cache.remove(o)
- if __name__ == '__main__':
- try:
- func_to_leak()
- except:
- pass
- objgraph.show_backrefs(objgraph.by_type('OBJ')[0], max_depth = 10, filename = 'obj.dot')
show_backrefs查看內(nèi)存泄露
注意,上面的代碼中,max_depth參數(shù)非常關(guān)鍵,如果這個參數(shù)太小,那么看不到完整的引用鏈,如果這個參數(shù)太大,運行的時候又非常耗時間。
然后打開dot文件,結(jié)果如下
可以看到泄露的對象(紅框表示),是被一個叫_cache的list所引用,而_cache又是被__main__這個module所引用。
對于示例代碼,dot文件的結(jié)果已經(jīng)非常清晰,但是對于真實項目,引用鏈中的節(jié)點可能成百上千,看起來非常頭大,下面用tornado起一個最最簡單的web服務器(代碼不知道來自哪里,且沒有內(nèi)存泄露,這里只是為了顯示引用關(guān)系),然后繪制socket的引用關(guān)關(guān)系圖,代碼和引用關(guān)系圖如下:
- import objgraph
- import errno
- import functools
- import tornado.ioloop
- import socket
- def connection_ready(sock, fd, events):
- while True:
- try:
- connection, address = sock.accept()
- print 'connection_ready', address
- except socket.error as e:
- if e.args[0] not in (errno.EWOULDBLOCK, errno.EAGAIN):
- raise
- return
- connection.setblocking(0)
- # do sth with connection
- if __name__ == '__main__':
- sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM, 0)
- sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
- sock.setblocking(0)
- sock.bind(("", 8888))
- sock.listen(128)
- io_loop = tornado.ioloop.IOLoop.current()
- callback = functools.partial(connection_ready, sock)
- io_loop.add_handler(sock.fileno(), callback, io_loop.READ)
- #objgraph.show_backrefs(sock, max_depth = 10, filename = 'tornado.dot')
- # objgraph.show_chain(
- # objgraph.find_backref_chain(
- # sock,
- # objgraph.is_proper_module
- # ),
- # filename='obj_chain.dot'
- # )
- io_loop.start()
- tornado_server實例
可見,代碼越復雜,相互之間的引用關(guān)系越多,show_backrefs越難以看懂。這個時候就使用show_chain和find_backref_chain吧,這種方法,在官方文檔也是推薦的,我們稍微改改代碼,結(jié)果如下:
- import objgraph
- _cache = []
- class OBJ(object):
- pass
- def func_to_leak():
- o = OBJ()
- _cache.append(o)
- # do something with o, then remove it from _cache
- if True: # this seem ugly, but it always exists
- return
- _cache.remove(o)
- if __name__ == '__main__':
- try:
- func_to_leak()
- except:
- pass
- # objgraph.show_backrefs(objgraph.by_type('OBJ')[0], max_depth = 10, filename = 'obj.dot')
- objgraph.show_chain(
- objgraph.find_backref_chain(
- objgraph.by_type('OBJ')[0],
- objgraph.is_proper_module
- ),
- filename='obj_chain.dot'
- )
上面介紹了內(nèi)存泄露的第一種情況,對象被“非期望”地引用著。下面看看第二種情況,循環(huán)引用中的__del__, 看下面的代碼:
- # -*- coding: utf-8 -*-
- import objgraph, gc
- class OBJ(object):
- def __del__(self):
- print('Dangerous!')
- def show_leak_by_del():
- a, b = OBJ(), OBJ()
- a.attr_b = b
- b.attr_a = a
- del a, b
- print gc.collect()
- objgraph.show_backrefs(objgraph.by_type('OBJ')[0], max_depth = 10, filename = 'del_obj.dot')
上面的代碼存在循環(huán)引用,而且OBJ類定義了__del__函數(shù)。如果沒有定義__del__函數(shù),那么上述的代碼會報錯, 因為gc.collect會將循環(huán)引用刪除,objgraph.by_type(‘OBJ’)返回空列表。而因為定義了__del__函數(shù),gc.collect也無能為力,結(jié)果如下:
從圖中可以看到,對于這種情況,還是比較好辨識的,因為objgraph將__del__函數(shù)用特殊顏色標志出來,一眼就看見了。另外,可以看見gc.garbage(類型是list)也引用了這兩個對象,原因在document中有描述,當執(zhí)行垃圾回收的時候,會將定義了__del__函數(shù)的類實例(被稱為uncollectable object)放到gc.garbage列表,因此,也可以直接通過查看gc.garbage來找出定義了__del__的循環(huán)引用。在這里,通過增加extra_ignore來排除gc.garbage的影響:
將上述代碼的最后一行改成:
- objgraph.show_backrefs(objgraph.by_type('OBJ')[0], extra_ignore=(id(gc.garbage),), max_depth = 10, filename = 'del_obj.dot')
另外,也可以設置DEBUG_UNCOLLECTABLE 選項,直接將uncollectable對象輸出到標準輸出,而不是放到gc.garbage
循環(huán)引用
除非定義了__del__方法,那么循環(huán)引用也不是什么萬惡不赦的東西,因為垃圾回收器可以處理循環(huán)引用,而且不準是python標準庫還是大量使用的第三方庫,都可能存在循環(huán)引用。如果存在循環(huán)引用,那么Python的gc就必須開啟(gc.isenabled()返回True),否則就會內(nèi)存泄露。但是在某些情況下,我們還是不希望有g(shù)c,比如對內(nèi)存和性能比較敏感的應用場景,在這篇文章中,提到instagram通過禁用gc,性能提升了10%;另外,在一些應用場景,垃圾回收帶來的卡頓也是不能接受的,比如RPG游戲。從前面對垃圾回收的描述可以看到,執(zhí)行一次垃圾回收是很耗費時間的,因為需要遍歷所有被collector管理的對象(即使很多對象不屬于垃圾)。因此,要想禁用GC,就得先徹底干掉循環(huán)引用。
同內(nèi)存泄露一樣,解除循環(huán)引用的前提是定位哪里出現(xiàn)了循環(huán)引用。而且,如果需要在線上應用關(guān)閉gc,那么需要自動、持久化的進行檢測。下面介紹如何定位循環(huán)引用,以及如何解決循環(huán)引用。
定位循環(huán)引用
這里還是是用GC模塊和objgraph來定位循環(huán)引用。需要注意的事,一定要先禁用gc(調(diào)用gc.disable()), 防止誤差。
這里利用之前介紹循環(huán)引用時使用過的例子: a, b兩個OBJ對象形成循環(huán)引用
- # -*- coding: utf-8 -*-
- import objgraph, gc
- class OBJ(object):
- pass
- def show_cycle_reference():
- a, b = OBJ(), OBJ()
- a.attr_b = b
- b.attr_a = a
- if __name__ == '__main__':
- gc.disable()
- for _ in xrange(50):
- show_cycle_reference()
- objgraph.show_most_common_types(20)
運行結(jié)果(部分):
- wrapper_descriptor 1060
- dict 555
- OBJ 100
上面的代碼中使用的是show_most_common_types,而沒有使用show_growth(因為growth會手動調(diào)用gc.collect()),通過結(jié)果可以看到,內(nèi)存中現(xiàn)在有100個OBJ對象,符合預期。當然這些OBJ對象沒有在函數(shù)調(diào)用后被銷毀,不一定是循環(huán)引用的問題,也可能是內(nèi)存泄露,比如前面OBJ對象被global作用域中的_cache引用的情況。怎么排除是否是被global作用域的變量引用的情況呢,方法還是objgraph.find_backref_chain(obj),在__doc__中指出,如果找不到符合條件的應用鏈(chain),那么返回[obj],稍微修改上面的代碼:
- # -*- coding: utf-8 -*-
- import objgraph, gc
- class OBJ(object):
- pass
- def show_cycle_reference():
- a, b = OBJ(), OBJ()
- a.attr_b = b
- b.attr_a = a
- if __name__ == '__main__':
- gc.disable()
- for _ in xrange(50):
- show_cycle_reference()
- ret = objgraph.find_backref_chain(objgraph.by_type('OBJ')[0], objgraph.is_proper_module)
- print ret
上面的代碼輸出:
- [<__main__.OBJ object at 0x0244F810>]
驗證了我們的想法,OBJ對象不是被global作用域的變量所引用。
在實際項目中,不大可能到處用objgraph.show_most_common_types或者objgraph.by_type來排查循環(huán)引用,效率太低。有沒有更好的辦法呢,有的,那就是使用gc模塊的debug 選項。在前面介紹gc模塊的時候,就介紹了gc.DEBUG_COLLECTABLE 選項,我們來試試:
- # -*- coding: utf-8 -*-
- import gc, time
- class OBJ(object):
- pass
- def show_cycle_reference():
- a, b = OBJ(), OBJ()
- a.attr_b = b
- b.attr_a = a
- if __name__ == '__main__':
- gc.disable() # 這里是否disable事實上無所謂
- gc.set_debug(gc.DEBUG_COLLECTABLE | gc.DEBUG_OBJECTS)
- for _ in xrange(1):
- show_cycle_reference()
- gc.collect()
- time.sleep(5)
上面代碼第13行設置了debug flag,可以打印出collectable對象。另外,只用調(diào)用一次show_cycle_reference函數(shù)就足夠了(這也比objgraph.show_most_common_types方便一點)。在第16行手動調(diào)用gc.collect(),輸出如下:
- gc: collectable <OBJ 023B46F0>
- gc: collectable <OBJ 023B4710>
- gc: collectable <dict 023B7AE0>
- gc: collectable <dict 023B7930>
注意:只有當對象是unreachable且collectable的時候,在collect的時候才會被輸出,也就是說,如果是reachable,比如被global作用域的變量引用,那么也是不會輸出的。
通過上面的輸出,我們已經(jīng)知道OBJ類的實例存在循環(huán)引用,但是這個時候,obj實例已經(jīng)被回收了。那么如果我想通過show_backrefs找出這個引用關(guān)系,需要重新調(diào)用show_cycle_reference函數(shù),然后不調(diào)用gc.collect,通過show_backrefs 和 by_type繪制。有沒有更好的辦法呢,可以讓我在一次運行中發(fā)現(xiàn)循環(huán)引用,并找出引用鏈?答案就是使用DEBUG_SAVEALL,下面為了展示方便,直接在命令行中操作(當然,使用ipython更好)
- >>> import gc, objgraph
- >>> class OBJ(object):
- ... pass
- ...
- >>> def show_cycle_reference():
- ... a, b = OBJ(), OBJ()
- ... a.attr_b = b
- ... b.attr_a = a
- ...
- >>> gc.set_debug(gc.DEBUG_SAVEALL| gc.DEBUG_OBJECTS)
- >>> show_cycle_reference()
- >>> print 'before collect', gc.garbage
- before collect []
- >>> print gc.collect()
- 4
- >>>
- >>> for o in gc.garbage:
- ... print o
- ...
- <__main__.OBJ object at 0x024BB7D0>
- <__main__.OBJ object at 0x02586850>
- {'attr_b': <__main__.OBJ object at 0x02586850>}
- {'attr_a': <__main__.OBJ object at 0x024BB7D0>}
- >>>
- >>> objgraph.show_backrefs(objgraph.at(0x024BB7D0), 5, filename = 'obj.dot')
- Graph written to obj.dot (13 nodes)
- >>>
上面在調(diào)用gc.collect之前,gc.garbage里面是空的,由于設置了DEBUG_SAVEALL,那么調(diào)用gc.collect時,會將collectable對象放到gc.garbage。此時,對象沒有被釋放,我們就可以直接繪制出引用關(guān)系,這里使用了objgraph.at,當然也可以使用objgraph.by_type, 或者直接從gc.garbage取對象,結(jié)果如下:
出了循環(huán)引用,可以看見還有兩個引用,gc.garbage與局部變量o,相信大家也能理解。
消滅循環(huán)引用
找到循環(huán)引用關(guān)系之后,解除循環(huán)引用就不是太難的事情,總的來說,有兩種辦法:手動解除與使用weakref。
手動解除很好理解,就是在合適的時機,解除引用關(guān)系。比如,前面提到的collections.OrderedDict:
- >>> root = []
- >>> root[:] = [root, root, None]
- >>>
- >>> root
- [[...], [...], None]
- >>>
- >>> del root[:]
- >>> root
- []
更常見的情況,是我們自定義的對象之間存在循環(huán)引用:要么是單個對象內(nèi)的循環(huán)引用,要么是多個對象間的循環(huán)引用,我們看一個單個對象內(nèi)循環(huán)引用的例子:
- class Connection(object):
- MSG_TYPE_CHAT = 0X01
- MSG_TYPE_CONTROL = 0X02
- def __init__(self):
- self.msg_handlers = {
- self.MSG_TYPE_CHAT : self.handle_chat_msg,
- self.MSG_TYPE_CONTROL : self.handle_control_msg
- }
- def on_msg(self, msg_type, *args):
- self.msg_handlers[msg_type](*args)
- def handle_chat_msg(self, msg):
- pass
- def handle_control_msg(self, msg):
- pass
上面的代碼非常常見,代碼也很簡單,初始化函數(shù)中為每種消息類型定義響應的處理函數(shù),當消息到達(on_msg)時根據(jù)消息類型取出處理函數(shù)。但這樣的代碼是存在循環(huán)引用的,感興趣的讀者可以用objgraph看看引用圖。如何手動解決呢,為Connection增加一個destroy(或者叫clear)函數(shù),該函數(shù)將 self.msg_handlers 清空(self.msg_handlers.clear())。當Connection理論上不在被使用的時候調(diào)用destroy函數(shù)即可。
對于多個對象間的循環(huán)引用,處理方法也是一樣的,就是在“適當?shù)臅r機”調(diào)用destroy函數(shù),難點在于什么是適當?shù)臅r機。
另外一種更方便的方法,就是使用弱引用weakref, weakref是Python提供的標準庫,旨在解決循環(huán)引用。
weakref模塊提供了以下一些有用的API:
(1)weakref.ref(object, callback = None)
創(chuàng)建一個對object的弱引用,返回值為weakref對象,callback: 當object被刪除的時候,會調(diào)用callback函數(shù),在標準庫logging (__init__.py)中有使用范例。使用的時候要用()解引用,如果referant已經(jīng)被刪除,那么返回None。比如下面的例子
- # -*- coding: utf-8 -*-
- import weakref
- class OBJ(object):
- def f(self):
- print 'HELLO'
- if __name__ == '__main__':
- o = OBJ()
- w = weakref.ref(o)
- w().f()
- del o
- w().f()
運行上面的代碼,第12行會拋出異常:AttributeError: ‘NoneType’ object has no attribute ‘f’。因為這個時候被引用的對象已經(jīng)被刪除了
(2)weakref.proxy(object, callback = None)
創(chuàng)建一個代理,返回值是一個weakproxy對象,callback的作用同上。使用的時候直接用 和object一樣,如果object已經(jīng)被刪除 那么跑出異常 ReferenceError: weakly-referenced object no longer exists。
- # -*- coding: utf-8 -*-
- import weakref
- class OBJ(object):
- def f(self):
- print 'HELLO'
- if __name__ == '__main__':
- o = OBJ()
- w = weakref.proxy(o)
- w.f()
- del o
- w.f()
注意第10行 12行與weakref.ref示例代碼的區(qū)別
(3)weakref.WeakSet
這個是一個弱引用集合,當WeakSet中的元素被回收的時候,會自動從WeakSet中刪除。WeakSet的實現(xiàn)使用了weakref.ref,當對象加入WeakSet的時候,使用weakref.ref封裝,指定的callback函數(shù)就是從WeakSet中刪除。感興趣的話可以直接看源碼(_weakrefset.py),下面給出一個參考例子:
- # -*- coding: utf-8 -*-
- import weakref
- class OBJ(object):
- def f(self):
- print 'HELLO'
- if __name__ == '__main__':
- o = OBJ()
- ws = weakref.WeakSet()
- ws.add(o)
- print len(ws) # 1
- del o
- print len(ws) # 0
(4)weakref.WeakValueDictionary, weakref.WeakKeyDictionary
實現(xiàn)原理和使用方法基本同WeakSet
總結(jié)
本文的篇幅略長,首選是簡單介紹了python的內(nèi)存管理,重點介紹了引用計數(shù)與垃圾回收,然后闡述Python中內(nèi)存泄露與循環(huán)引用產(chǎn)生的原因與危害,最后是利用gc、objgraph、weakref等工具來分析并解決內(nèi)存泄露、循環(huán)引用問題。
references
- Garbage Collector Interface
- objgraph
- Garbage Collection for Python
- 禁用Python的GC機制后,Instagram性能提升10%
- Python內(nèi)存管理機制及優(yōu)化簡析
- library weakref