[PYTHON] weakref 모듈 사용 방법과 순환 참조 2가지 문제 해결 및 성능 차이 분석

weakref 모듈

 

파이썬은 강력한 가비지 컬렉터(Garbage Collector)를 가진 언어지만, 개발자가 객체 간의 관계를 잘못 설계하면 메모리 누수의 늪에 빠지기 쉽습니다. 특히 대규모 캐시 시스템이나 복잡한 객체 그래프를 다룰 때 '강한 참조(Strong Reference)'는 객체의 생명 주기를 불필요하게 연장합니다. 이때 구원투수로 등장하는 것이 바로 weakref 모듈입니다. 본 아티클에서는 파이썬의 약한 참조가 무엇인지, 그리고 실무에서 메모리 효율을 극대화하기 위해 이를 어떻게 활용하는지 깊이 있게 다룹니다.

1. 강한 참조와 약한 참조의 결정적 차이

파이썬의 기본 할당 방식은 '강한 참조'입니다. 어떤 객체를 가리키는 강한 참조가 하나라도 남아있다면, 가비지 컬렉터는 해당 객체를 메모리에서 제거하지 않습니다. 반면, 약한 참조(Weak Reference)는 객체를 가리키고는 있지만, 객체의 레퍼런스 카운트(Reference Count)를 증가시키지 않습니다.

왜 약한 참조가 필요한가?

객체가 오직 약한 참조에 의해서만 가리켜지고 있다면, 파이썬은 해당 객체를 '사용되지 않는 것'으로 간주하고 즉시 소멸시킬 수 있습니다. 이는 대용량 데이터를 메모리에 캐싱할 때, 메모리가 부족하면 시스템이 자동으로 데이터를 비울 수 있게 만드는 유연한 방법을 제공합니다.

---

2. 순환 참조 문제의 해결: weakref의 실무적 가치

두 객체가 서로를 강하게 참조하는 '순환 참조(Circular Reference)'는 파이썬 가비지 컬렉션의 세대별 수집 알고리즘을 복잡하게 만들고 성능 저하를 유발합니다. weakref.proxy나 weakref.ref를 사용하면 이러한 고리를 끊을 수 있습니다.

표: 강한 참조(Strong Ref) vs 약한 참조(Weak Ref) 상세 비교

비교 항목	강한 참조 (Default)	약한 참조 (weakref)
레퍼런스 카운트	1 증가 (소멸 방해)	증가하지 않음 (소멸 허용)
객체 생명 주기	참조가 있는 한 영구 유지	대상이 소멸되면 자동으로 None 반환
주요 용도	일반적인 변수 할당 및 로직	캐시, 프레임워크 객체 그래프, 이벤트 리스너
성능 영향	안정적이지만 메모리 누수 위험	관리 오버헤드 발생하나 메모리 효율적

3. weakref 모듈의 핵심 도구들

실제 개발에서 가장 많이 활용되는 weakref의 기능은 크게 세 가지입니다.

• weakref.ref: 객체에 대한 약한 참조를 생성합니다. 대상이 사라졌는지 () 호출을 통해 확인할 수 있습니다.
• weakref.proxy: 참조 대상을 직접 사용하는 것과 똑같은 인터페이스를 제공하는 대리자 객체입니다. 대상이 소멸된 후 접근하면 ReferenceError가 발생합니다.
• weakref.WeakValueDictionary: 값이 약한 참조로 저장되는 딕셔너리입니다. 값이 더 이상 사용되지 않으면 딕셔너리에서 자동으로 해당 키-값 쌍이 삭제됩니다.

4. Sample Example: 메모리 자동 관리 시스템 구현

아래 코드는 WeakValueDictionary를 사용하여 대규모 이미지 객체를 관리하는 캐시 시스템의 예시입니다.

import weakref
import gc

class LargeData:
    def __init__(self, name):
        self.name = name
    def __del__(self):
        print(f"객체 {self.name}가 메모리에서 완전히 삭제되었습니다.")

# 1. 일반 딕셔너리와의 차이점 확인
cache = weakref.WeakValueDictionary()

data1 = LargeData("BigAsset_01")
cache["asset_1"] = data1

print(f"캐시 상태: {list(cache.keys())}")

# 2. 강한 참조(data1) 제거
del data1

# 3. 가비지 컬렉션 강제 실행 (또는 자연 소멸 대기)
gc.collect()

print(f"강한 참조 제거 후 캐시 상태: {list(cache.keys())}")
# 결과: 객체가 자동으로 캐시에서 사라짐 (메모리 확보)

5. 주의사항: 모든 객체에 쓸 수 있는 것은 아니다

파이썬의 모든 객체가 약한 참조를 지원하는 것은 아닙니다. list, dict, int와 같은 일부 내장 자료구조는 성능상의 이유로 __weakref__ 슬롯이 기본적으로 존재하지 않습니다. 이를 해결하려면 해당 클래스를 상속받아 __slots__에 '__weakref__'를 추가하거나, 사용자 정의 클래스를 구성해야 합니다.

6. 결론: 전문가를 위한 메모리 최적화 전략

weakref는 단순히 메모리를 아끼는 도구가 아니라, 객체 간의 소유권을 명확히 하고 결합도(Coupling)를 낮추는 설계 도구입니다. 대형 프레임워크나 복잡한 UI 엔진을 개발 중이라면, 부모-자식 관계가 아닌 '참조' 관계에는 항상 약한 참조 도입을 검토하십시오. 이는 예기치 못한 메모리 팽창을 막고 가비지 컬렉터의 부담을 덜어주는 가장 확실한 방법입니다.

참조 문헌 및 기술 출처

• Python Official Docs
• Effective Python (2nd Edition) by Brett Slatkin: Item 54.
• Fluent Python by Luciano Ramalho: Object References, Mutability, and Recycling.