4-4. 덤프 분석 | UE5 GC Deep Dive

SECTION 01

obj dump 명령어

특정 UObject의 상세 프로퍼티를 덤프하여 분석

obj dump 사용법

                    콘솔
                    // 특정 객체의 프로퍼티 덤프
obj dump MyActor_42

// 출력 예시:
  Object: MyActor_42 (Class: AMyActor)
  Outer: PersistentLevel
  Flags: RF_Transactional
  InternalFlags: None
  Properties:
    Health = 100
    MeshComponent = StaticMeshComponent_0
    TargetActor = OtherActor_15    ← 참조 확인!
    Inventory = [UItem_0, UItem_1, UItem_2]

// 클래스 단위 덤프
obj dump class=AMyActor

// Outer 체인 확인 (소유권 구조)
// MyActor_42 → PersistentLevel → World → Package
                

덤프에서 GC 문제 발견하기

obj dump에서 확인할 핵심 사항:

Outer 체인: 예상치 못한 Outer가 있으면 GC 수명이 달라질 수 있음
Flags: RF_Standalone이 불필요하게 설정되어 있지 않은지
참조 프로퍼티: 파괴되어야 할 객체를 여전히 참조하는지

SECTION 02

메모리 할당 추적 (FMalloc)

엔진의 메모리 할당기를 활용한 저수준 추적

FMalloc 기반 추적

                    커맨드라인
                    // 메모리 히스토리 추적 활성화
-MallocFrameProfiler      // 프레임별 할당 프로파일링
-MallocLeakReporting       // 누수 리포트

// 런타임 메모리 통계
stat memory

// 출력:
Total Physical:     16384 MB
Used Physical:       8234 MB
Peak Physical:       9120 MB
Used Virtual:       12450 MB

// 메모리 리포트 출력
memreport -full

// 결과 파일: Saved/Profiling/MemReports/
// MemReport_YYYY-MM-DD_HH-MM-SS.memreport
                

memreport 파일 분석

                    memreport 내용
                    // memreport 파일의 주요 섹션:

=== UObject Count ===
Total UObjects: 85,234
  AStaticMeshActor:    12,500
  UStaticMeshComponent: 12,500
  UMaterial:            3,200
  UTexture2D:           2,800
  ...

=== Memory by Category ===
UObject Overhead:     45.2 MB
FName Table:          12.8 MB
TArray Slack:          8.4 MB
Texture Memory:      156.4 MB

=== Top Memory Consumers ===
T_LargeTexture_4K:    64.0 MB
SM_ComplexMesh:        32.5 MB
SK_Character:          16.2 MB
                

SECTION 03

커스텀 메모리 리포트

프로젝트 특화 메모리 진단 도구 구축

커스텀 리포트 구현

                    C++
                    // 커스텀 GC 리포트 Exec 명령
static bool Exec_GCReport(UWorld* World, const TCHAR* Cmd)
{
    TMap<UClass*, int32> ClassCounts;
    TMap<UClass*, SIZE_T> ClassMemory;

    for (FThreadSafeObjectIterator It; It; ++It)
    {
        UObject* Obj = *It;
        ClassCounts.FindOrAdd(Obj->GetClass())++;

        FResourceSizeEx Size;
        Obj->GetResourceSizeEx(Size);
        ClassMemory.FindOrAdd(Obj->GetClass()) +=
            Size.GetTotalMemoryBytes();
    }

    // 결과 정렬 및 출력
    ClassCounts.ValueSort([](int32 A, int32 B)
    {
        return A > B;
    });

    UE_LOG(LogGC, Warning, TEXT("=== GC Report ==="));
    for (auto& Pair : ClassCounts)
    {
        UE_LOG(LogGC, Warning,
            TEXT("  %s: %d objects, %.2f MB"),
            *Pair.Key->GetName(),
            Pair.Value,
            ClassMemory[Pair.Key] / 1024.0 / 1024.0);
    }
    return true;
}
                

SECTION 04

크래시 덤프에서 GC 분석

크래시 덤프 파일에서 GC 관련 문제를 진단하는 방법

GC 관련 크래시 패턴

                    크래시 패턴
                    // 패턴 1: 댕글링 포인터 접근
Access Violation at 0xDDDDDDDD
// → UPROPERTY 누락으로 GC된 객체 접근

// 패턴 2: GC 중 접근
Assertion failed: !IsGarbageCollecting()
// → GC 진행 중 UObject 생성/파괴 시도

// 패턴 3: 유효하지 않은 UObject
Fatal: UObject has invalid Flags
// → 이미 파괴된 UObject의 메모리를 다른 용도로 재사용

// 패턴 4: FinishDestroy 중 크래시
Crash in UMyObject::FinishDestroy
// → BeginDestroy에서 리소스 정리 미흡

// 디버거에서 확인할 것:
// 1. GUObjectArray에서 해당 인덱스 확인
// 2. FUObjectItem의 Flags 확인
// 3. SerialNumber 일치 여부 확인
                

0xDDDDDDDD 패턴

Visual Studio 디버그 빌드에서 해제된 메모리는 0xDD로 채워집니다. 접근 위반 주소가 0xDDDDDDDD 근처이면 이미 GC된 UObject에 접근한 것입니다. UPROPERTY() 누락이 가장 흔한 원인입니다.

SUMMARY

핵심 요약

이 강의에서 배운 내용

obj dump으로 특정 UObject의 프로퍼티, Outer 체인, 플래그를 상세히 분석합니다
memreport -full로 전체 메모리 사용량 리포트를 파일로 출력합니다
커스텀 GC 리포트를 구현하여 프로젝트 특화 메모리 진단이 가능합니다
0xDDDDDDDD 크래시는 GC된 UObject 접근(UPROPERTY 누락)이 원인입니다
stat memory와 LLM을 병행하여 전체 메모리 상태를 모니터링합니다

PRACTICE

도전 과제

배운 내용을 직접 실습해보세요

실습 1: memreport 분석 실습

memreport -full 명령어를 실행하여 생성된 .memreport 파일을 분석하세요. UObject 클래스별 인스턴스 수, 메모리 사용량, 가장 큰 객체 목록을 정리하고, 비정상적으로 많은 인스턴스를 가진 클래스를 식별하세요.

실습 2: Obj Dump를 이용한 개별 객체 분석

obj dump 명령어로 특정 UObject의 전체 프로퍼티 덤프를 확인하세요. UPROPERTY 값, 참조하는 외부 객체, Object Flags 등을 분석하여 해당 객체의 GC 관련 상태를 종합적으로 파악하세요.

심화 과제: 메모리 스냅샷 비교 도구 구현

두 시점의 memreport를 자동으로 비교하여 새로 생성된 객체, 삭제된 객체, 메모리 증가/감소를 보고하는 Python 또는 C++ 도구를 개발하세요. 레벨 전환 전후의 메모리 변화를 자동 분석하세요.