18강. 디버깅과 테스트: 재현 절차·로그·체크리스트로 문제 찾기

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

“가끔 점수가 두 번 올라요”만으로는 조건을 찾기 어렵습니다. 실행 버전, Inspector 값, 입력 순서와 첫 오류를 기록하고 같은 체크리스트로 수정 전후를 비교합니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 기대 결과와 실제 결과가 있는 재현 문서를 작성합니다.
• 로그에 상태와 객체 Context를 넣되 민감 정보는 제외합니다.
• 정상·경계·빠른 생성·긴 플레이를 반복 검증합니다.

◇3. 핵심 개념

Unity Console의 첫 오류와 Stack Trace에서 시작합니다. null은 필드 이름, GameObject와 Scene을 확인하고 Inspector 참조를 고칩니다. 로그는 상태 전환과 판정처럼 드문 사건에만 남기며 Update에서 매 프레임 출력하지 않습니다.

✎4. 단계별 실습

C# · GameFlowController.SetState에 개발 로그 추가

GameFlowController.cs

private void SetState(GameState next)
{
    if (State == next) return;
    Debug.Log($"Game state: {State} -> {next}", this);
    State = next;
    StateChanged?.Invoke(State);
}

문서 · 파일 경로: Assets/_Project/Docs/Bugs/001-double-score.md

001-double-score.md

# 중복 점수 재현
- Unity 버전과 Scene:
- Inspector 변경값:
- 절차: 택배를 겹친 두 Zone 경계로 이동
- 기대: 결과 이벤트 1회, 점수 1회 증가
- 실제:
- 첫 Console 메시지와 Stack Trace:
- 원인:
- 수정 후 검증:

PowerShell · 실행 위치: 프로젝트 루트

Get-Content .\ProjectSettings\ProjectVersion.txt
Get-ChildItem .\Assets\_Project\Docs\Bugs

예상 결과: 재현에 사용한 엔진 버전과 버그 문서가 보입니다.

테스트 작업: 일반 플레이, 0.1초 빠른 생성, 택배가 없는 상황, 목숨 0, 잘못된 Inspector 연결, 15분 플레이를 수행합니다. 각 결과와 Console 오류 수를 기록합니다.

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

상태가 실제로 바뀔 때만 Context가 있는 로그를 남겨 어떤 GameFlow 인스턴스에서 전환했는지 알 수 있습니다. 동일 절차와 조건이 수정 전후 비교 기준을 만듭니다.

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

!자주 하는 실수

• 증상만 ‘안 됨’으로 기록: 환경, 절차, 기대·실제 결과를 씁니다.
• Update에서 로그 도배: 사건과 상태 전환만 출력합니다.
• null마다 Find로 임시 해결: Inspector 연결과 생성 시 전달을 고칩니다.
• 일반 플레이만 테스트: 빠른 생성, 빈 상태, 0 목숨과 긴 플레이를 포함합니다.

✎7. 직접 실습

✎필수 테스트 체크리스트

• 일반 플레이에서 두 종류와 두 Zone이 정확히 동작한다.
• 빠른 생성에서 Pool 중복 반환과 중복 점수가 없다.
• 택배가 없는 동안 오류 없이 다음 생성을 기다린다.
• 목숨 0에서 입력·생성이 멈추고 GameOver가 한 번 표시된다.
• Inspector 참조를 비우면 필드 이름이 있는 오류가 나온다.
• 15분 플레이에서 수치·구독·비활성 객체가 계속 증가하지 않는다.

?8. 이해 점검 질문 3개

?이해 점검

1. 첫 Console 오류부터 확인하는 이유는 무엇인가요?
2. 로그에 Unity Object Context를 넣으면 어떤 점이 좋아지나요?
3. 긴 플레이 테스트가 짧은 테스트와 다르게 찾는 문제는 무엇인가요?

■9. 핵심 요약

■핵심 요약

재현 절차와 상태 중심 로그로 문제 범위를 좁히고 같은 체크리스트로 수정 결과를 검증합니다. null과 반복 문제는 구조적 원인을 고칩니다.