23강. 디버깅·로그·성능 점검

?1. 이번 강의에서 해결할 문제

"가끔 점수가 두 번 오른다" 또는 "적이 많으면 느리다"는 설명만으로는 고칠 수 없습니다. 재현 조건, 관찰 정보와 측정값을 남겨 원인을 좁힙니다.

✓2. 학습 목표

✓이 강의를 마치면

• Console 스택 추적으로 null 발생 위치를 찾습니다.
• 조건과 객체 컨텍스트가 있는 로그를 작성합니다.
• Profiler로 Update, Instantiate와 GC 비용을 비교합니다.

◇3. 핵심 개념

디버깅은 재현 → 관찰 → 가설 → 한 번에 한 변경 → 재검증 순서입니다. 성능 수치는 PC 사양, Unity 세부 버전, Game View 해상도와 Scene 구성에 따라 달라지므로 절대 숫자보다 같은 조건 전후를 비교합니다.

✎4. 단계별 실습

C# · 파일 경로: Assets/DeliverySorter/Scripts/Diagnostics/RequiredReference.cs

RequiredReference.cs

using UnityEngine;

public static class RequiredReference
{
    public static bool Check(Object value, string fieldName, Object context)
    {
        if (value != null) return true;
        Debug.LogError($"Required reference is missing: {fieldName}", context);
        return false;
    }
}

진단 로그 예시 · SortZone

SortZone.cs

Debug.Log(
    $"Sort resolved package={package.Type.Id}, zone={acceptedType.Id}, correct={correct}",
    package);

Unity Editor 점검

1. Inspector에서 HUD 텍스트 하나를 비우고 오류의 첫 사용자 코드 줄과 객체 컨텍스트를 찾습니다.
2. Physics 2D 디버그 도구로 Package와 Zone Collider가 겹치는지 확인합니다.
3. Profiler의 CPU Usage와 Memory를 기록하고 0.15초 생성 간격에서 Instantiate/Destroy 버전과 Pool 버전을 비교합니다.
4. Deep Profile은 측정 자체의 비용이 크므로 필요한 짧은 구간에서만 사용합니다.

측정 기록 · 파일 경로: Docs/PerformanceCheck.md

Docs/PerformanceCheck.md

# Performance check
- Unity version / PC / Game View resolution:
- Scenario: 60 seconds, spawn interval 0.15s
- Before: active count, CPU frame time, GC Alloc
- After pool: active count, CPU frame time, GC Alloc
- Conclusion: keep or remove pool, with reason

→5. 코드가 동작하는 이유

오류 로그에 필드명과 context 객체를 함께 주면 Console에서 문제 GameObject를 바로 선택할 수 있습니다. 동일한 장면과 생성 조건을 유지한 전후 비교는 Pool이 실제 병목을 줄였는지 판단하게 합니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• NullReferenceException의 마지막 줄만 봄: 스택에서 처음 등장하는 자신의 스크립트 줄부터 확인합니다.
• Update에서 Debug.Log 반복: 필요한 사건에서만 로그하고 측정 전 제거하거나 조건부로 만듭니다.
• Find 계열을 매 프레임 호출: Inspector 참조, 캐시 또는 생성 시 전달로 교체합니다.
• 한 번에 여러 수정: 하나의 가설만 바꾸고 같은 재현 단계로 비교합니다.

✎7. 직접 실습

✎직접 실습

잘못된 Inspector 연결, 중복 Zone 겹침, 빠른 생성 세 문제를 일부러 재현하세요. 각 문제의 재현 단계, 관찰 로그, 원인, 수정, 재검증 결과를 한 줄씩 기록합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 오류 로그에 context 객체를 넣으면 어떤 점이 편리한가요?
2. 성능 측정에서 같은 Scene과 생성 조건을 유지해야 하는 이유는 무엇인가요?
3. Update의 Find와 Debug.Log 호출이 많을 때 먼저 어떤 구조를 바꿔야 하나요?

■9. 핵심 요약

■핵심 요약

재현 가능한 단계와 문맥 있는 로그로 기능 오류를 좁히고 Profiler의 같은 조건 전후 비교로 성능 결정을 내립니다. 측정값은 PC와 Scene에 따라 달라짐을 함께 기록합니다.