Unity - (16) 각 항목별 버그 소재 (3)
7. Static, 싱글톤, 오브젝트 풀
7.1. 싱글턴 인스턴스 초기화 타이밍 문제로 인한 NullReference 예외
[ ] 여러 컴포넌트(Player, GameManager 등)가 각자의 Awake() 단계에서 서로의 싱글턴 인스턴스나 전역 상태를 참조할 때, 유니티의 스크립트 실행 순서(Execution Order) 보장 부재로 인해 아직 SetSingleton()이 호출되지 않아 인스턴스가 null인 상태로 접근하여 NullReferenceException이 발생하는가?
7.2. 씬 전환 시 싱글턴 중복 생성 및 씬 파괴 오류
[ ] 싱글턴 클래스에 DontDestroyOnLoad(gameObject)를 적용했으나, 씬을 다시 로드하거나 되돌아왔을 때 기존 오브젝트가 파괴되지 않고 누적되거나 중복 생성되어 매니저가 여러 개 공존하는 오작동 버그가 있는가? (이미 존재하는 인스턴스가 있을 경우 현재 생성된 자신을 Destroy(gameObject) 처리하는 로직 검증 필요)
7.3. 싱글턴 프로퍼티의 자동 검색(FindObjectOfType) 남용으로 인한 성능 저하 및 엉뚱한 객체 참조
[ ] Instance 프로퍼티의 get 접근자 내부에서 _instance == null일 때 동적으로 FindObjectOfType()를 호출하도록 구현했을 경우, 씬 내에 해당 매니저가 존재하지 않거나 비활성화되어 있으면 매 프레임 혹은 호출 때마다 무거운 검색 연산이 수행되어 프레임 드랍(스파이크)이 발생하거나 의도하지 않은 오브젝트를 가져오는가?
7.4. 오브젝트 풀 Take() 시 풀 고갈(IsEmpty)에 대한 예외 처리 누락
[ ] 오브젝트 풀의 용량(Size)을 초과하여 아이템을 계속 꺼내가려 할 때, Take() 메서드 내부에서 IsEmpty 검사를 누락하거나 반환값이 null일 때의 방어 코드가 없어서 _pool[Count] 배열 인덱스 초과(IndexOutOfRangeException) 또는 null.transform 접근으로 인한 크래시가 발생하는가?
7.5. 오브젝트 풀 반환(Return) 누락으로 인한 풀 고갈 및 메모리 누수
[ ] 총알이나 이펙트 등의 오브젝트가 사용 완료된 뒤 Destroy 대신 정해진 풀의 ReturnToPool()을 호출하여 상태를 되돌리고 비활성화(SetActive(false))해야 하는데, 이를 누락하여 풀 내의 가용 객체가 바닥나고 더 이상 오브젝트를 생성·재사용할 수 없게 되는 버그가 있는가?
8. Delegate, 이벤트, Unity Action, Unity Events
8.1. 델리게이트 구독 해제 누락으로 인한 메모리 누수(Memory Leak) 및 댕글링 참조
[ ] UI나 바인더(PlayerUIBinder 등)가 활성화/비활성화되거나 파괴될 때(OnDisable 또는 OnDestroy), _player.OnHealthChanged -= ...와 같은 구독 해제 코드를 누락하여 이미 파괴된 오브젝트의 메서드를 메모리가 계속 참조하게 되는 메모리 누수 및 예외 발생 가능성이 있는가?
8.2. 대입 연산자(=) 사용으로 인한 기존 구독 목록 소실(덮어쓰기)
[ ] 델리게이트나 이벤트를 등록할 때 누락 방지를 위해 누적 연산자인 +=를 써야 함에도 불구하고, 실수로 대입 연산자 =를 사용하여(Player.OnHealthChanged = RefreshHealthUI;) 기존에 등록되어 있던 다른 UI나 기능들의 구독이 전부 지워지고 마지막에 등록된 기능만 동작하는 오작동 버그가 발생하는가?
8.3. 이벤트 발화 시 널(Null) 체크 누락으로 인한 NullReferenceException
[ ] 델리게이트나 액션에 등록된 메서드가 단 하나도 없는(구독자가 없는) 상태에서 OnHealthChanged(playerHp);처럼 널 체크 없이 곧바로 호출(Invoke)하여 NullReferenceException 크래시가 발생하는가? (OnHealthChanged?.Invoke(...) 형태로 방어 코드가 작성되어 있는지 확인 필요)
8.4. 씬 전환 또는 오브젝트 생명주기에 따른 초기화 타이밍 오류 (Null Ref)
[ ] TempPlayer 내부의 Exp 같은 ObservableProperty 커스텀 클래스가 선언만 되고 인스턴스화(new ObsevableProperty(0))되지 않았거나, Awake 시점의 초기화 순서 문제로 인해 다른 스크립트가 참조하려 할 때 null 상태여서 예외가 발생하는가?
8.5. 이벤트/액션 내부에서 무한 루프 또는 연쇄 상태 변경(Stack Overflow) 유발
[ ] 프로퍼티의 set 접근자 내부나 델리게이트 체인으로 연결된 메서드 안에서 다시 자신의 값을 변경하는 로직이 섞여 들어가, 값이 바뀔 때마다벤트를 호출하고 그 이벤트가 다시 값을 바꾸는 무한 재귀 호출로 인해 StackOverflowException이 발생하는가?
9. 코루틴
9.1. new WaitForSeconds 반복 생성으로 인한 가비지 컬렉터(GC) 스파이크 및 성능 저하
[ ] 코루틴 내부의 while 문 등에서 매번 yield return new WaitForSeconds(1f);처럼 new 키워드를 사용하여 대기 객체를 생성할 경우, 매 주기마다 힙(Heap) 메모리에 쓰레기(Garbage)가 누적되어 가비지 컬렉터(GC)가 빈번히 동작하고 게임이 뚝뚝 끊기는 프레임 드랍(스파이크) 현상이 발생하는가? (필드에 미리 캐싱해 두거나 WaitForSeconds 객체를 재활용하고 있는지 확인 필요)
9.2. 코루틴 참조 변수(Coroutine) 초기화 누락으로 인한 중복 실행 및 정지 불가 오류
[ ] StartCoroutine() 실행 시 반환된 코루틴 레퍼런스를 _routine 변수에 담을 때, 코루틴이 스스로 종료되거나 외부에서 멈출 때 _routine = null; 처리를 누락하여 이미 끝난 코루틴임에도 _routine != null 상태로 남아버려 새로운 코루틴이 실행되지 않거나 엉뚱한 코루틴을 StopCoroutine() 하려다 예외/오작동이 발생하는가?
9.3. 파괴된(Destroyed) GameObject에서의 코루틴 실행 및 컴포넌트 생명주기 불일치
[ ] 오브젝트가 비활성화되거나 파괴(Destroy)되는 시점에도 백그라운드에서 돌고 있던 코루틴이 정지되지 않고 계속 실행되려 하거나, 이미 파괴된 컴포넌트의 변수를 참조하려다 MissingReferenceException 크래시가 발생하는가?
9.4. StopCoroutine() 사용 시 문자열(String) 방식 남용으로 인한 중지 누락
[ ] 코루틴을 멈출 때 StopCoroutine("MyRoutine")과 같이 메서드 이름을 문자열로 전달할 경우, 오타가 발생해도 컴파일 에러가 나지 않아 런타임에 코루틴이 멈추지 않고 계속 폭주하는 버그가 발생하는가? (반환된 Coroutine 객체 레퍼런스나 IEnumerator 변수를 직접 넘겨서 제어하는 것이 안전)
9.5. Time.timeScale = 0 (게임 일시정지) 상태에서의 코루틴 무한 대기 버그
[ ] 게임을 일시정지하기 위해 Time.timeScale = 0으로 설정했을 때, 일반적인 WaitForSeconds는 시간 흐름까지 멈춰버려 일시정지 해제 조건 등을 체크하는 코루틴 전체가 영구적으로 멈추거나 씹히는 오작동이 발생하는가? (일시정지 중에도 흘러가야 하는 대기 처리에는 WaitForSecondsRealtime 사용 고려 필요)
10. 애니메이션
10.1. 애니메이터 파라미터 문자열 직접 사용으로 인한 오타 및 성능 저하 (매직 스트링)
[ ] 애니메이터 컴포넌트에 접근할 때 _animator.SetBool("IsMove", true)나 _animator.SetTrigger("Attack")처럼 파라미터 이름을 문자열 그대로 직접 전달할 경우, 코드 내 오타가 발생해도 컴파일 시점에 발견되지 않아 런타임에 애니메이션이 정상 전이되지 않는 버그가 발생하는가? (필기에서 권장하듯 Animator.StringToHash()를 이용해 해시값으로 변환하여 관리하고 있는지 확인 필요)
10.2. 트리거(Trigger) 파라미터 중복 호출 또는 잔류로 인한 오작동
[ ] 단발성 애니메이션 제어를 위해 사용하는 SetTrigger()를 짧은 시간에 연속으로 호출하거나, 조건이 충족되지 않아 트리거가 소모되지 않은 상태로 누적될 때 의도하지 않은 시점에 공격 등의 애니메이션이 갑자기 튀어나거나 발동하는 버그가 발생하는가?
10.3. 애니메이션 이벤트(Animation Event) 대상 메서드 이름 불일치 및 누락
[ ] 타임라인에 등록한 애니메이션 이벤트(예: OnHit)와 실제 스크립트에 구현된 메서드의 이름이 서로 다르거나, 스크립트가 해당 오브젝트에 부착되어 있지 않아 재생 도중 경고(Warning) 및 런타임 예외가 발생하며 이벤트가 무시되는가?
10.4. 씬 전환 또는 오브젝트 비활성화 시 애니메이터 상태 불일치 (파라미터 초기화 누락)
[ ] 캐릭터가 이동 중이거나 공격 모션 도중에 강제로 UI가 꺼지거나 씬이 전환되어 오브젝트가 비활성화(OnDisable)될 때, 애니메이터 내부의 bool이나 float 파라미터 상태(예: IsMove = true)가 그대로 남아있다가 나중에 다시 활성화되었을 때 가만히 서 있어도 걷는 애니메이션이 재생되는 등 상태 동기화 오류가 발생하는가?
10.5. 루트 모션(Root Motion) 활성화로 인한 위치 충돌 및 의도치 않은 좌표 이탈
[ ] 캐릭터 컨트롤러나 이동 스크립트에서 직접 위치(Transform 또는 Rigidbody)를 제어하고 있음에도 애니메이션 클립의 루트 모션(Apply Root Motion)이 켜져 있거나 설정이 잘못되어, 애니메이션 자체의 이동 값과 스크립트의 이동 값이 충돌하여 캐릭터가 공중으로 솟구치는가?




