Unity - (15) 각 항목별 버그 소재 (2)

이형눈이이상해
이형눈이이상해
∙∙조회 4

4. 물리 및 충돌, Raycast

4.1. Rigidbody 이동 시 불필요한 Time.deltaTime 곱셈으로 인한 속도 저하 버그

[ ] Transform 이동과 혼동하여 _rigidbody.velocity나 AddForce를 적용할 때 Time.deltaTime을 곱해버려, 물리 엔진 갱신 주기와 충돌해 오브젝트의 움직임이 극단적으로 느려지거나 멈추는 현상이 발생하고 있지 않은가?

4.2. FixedUpdate 내의 키 입력 누락(씹힘) 현상

[ ] 물리 처리라는 이유로 Update() 대신 FixedUpdate() 내부에서 Input.GetKeyDown 같은 키 입력을 받아, 프레임 주기에 따라 입력이 스킵되거나 키 씹힘 현상이 발생할 구조로 코드가 짜여 있지는 않은가? (키 입력은 Update, 물리 연산은 FixedUpdate로 분리 확인)

4.3. 높은 위치에서 낙하 시 충돌체 통과 버그 (터널링 현상)

[ ] Rigidbody를 가진 물체를 너무 높은 곳에서 떨어뜨리거나 속도가 지나치게 빠를 때, 물리 엔진이 프레임 간격을 건너뛰어 바닥이나 벽을 그대로 통과해 버리는 버그가 발생할 위험은 없는가? (Collision Detection 모드 변경 검토 필요)

4.4. RaycastAll 배열 순회 시 Null 또는 예외 발생 위험

[ ] Physics.RaycastAll을 통해 얻은 RaycastHit[] 배열을 사용할 때, 결과 배열의 길이(Length)를 검사하지 않거나 빈 배열에 접근하여 예외를 유발할 위험은 없는가? (또는 반환된 hit.transform에 유효한 컴포넌트가 있는지 방어 코드가 있는가?)

4.5. 타깃 미지정 상태의 마우스 우클릭 이동에 따른 NullReference 예외

[ ] 마우스 좌클릭으로 유닛을 선택하지 않았거나(_target null), 빈 바닥(Ground)을 클릭해 타깃이 해제된 상태에서 우클릭으로 이동 함수(SetDestination)를 호출하여 NullReferenceException 에러가 발생하고 있지는 않은가? (if (_target null) return; 방어 코드 유무 확인)

5. Layermask

5.1. LayerMask 직접 동등 비교(==)로 인한 판정 누락 버그

[ ] 레이어 마스크를 판별할 때 비트 연산(&)을 사용하지 않고 layerTargetLayer.value와 같이 단순 비교를 수행하여, 다중 레이어가 선택되었거나 비트 자릿수가 일치하지 않을 때 충돌 판정이 통째로 무시되는 버그가 발생하고 있는가? ((TargetLayer.value & layer) != 0 형태로 비트 연산 확인)

5.2. Raycast 시 LayerMask 인자 누락으로 인한 의도치 않은 오브젝트 감지

[ ] Physics.Raycast를 호출할 때 필터링 역할을 하는 TargetLayer 인자를 누락하여, 원치 않는 주변 오브젝트나 배경(Ground 등)이 레이에 먼저 감지되어 터렛이나 유닛의 상호작용이 엉키는 버그가 발생하고 있는가?

5.3. 비트 시프트(<<) 및 반전 연산자(~) 실수로 인한 레이어 제어 오류

[ ] 확장 메서드를 통해 레이어를 추가(Add)하거나 제거(Remove)할 때, 1 << layer 자릿수 계산을 실수하거나 제거 로직에서 비트 반전 연산자(~)를 누락하여 원하는 레이어가 정상적으로 켜지거나 꺼지지 않는 오작동 버그가 있는가?

5.4. 필수 컴포넌트 누락으로 인한 런타임 NullReference 예외

[ ] 스크립트 내부에서 Rigidbody 등의 물리 컴포넌트를 가져다 쓰거나 제어할 때, 해당 컴포넌트가 게임 오브젝트에 부착되어 있지 않아 런타임 에러(NullReferenceException)를 유발할 위험은 없는가? RequireComponent(typeof(Rigidbody) 적용 여부 확인)

6. UI 구성

6.1. 해상도 변경에 따른 UI 위치 이탈 및 잘림 현상 (앵커/피벗 미설정)

[ ] 다양한 모니터 해상도나 화면 비율에 맞춰 UI가 유연하게 대응하도록 앵커(Anchor)와 피벗(Pivot)을 올바르게 설정하지 않아, 화면이 바뀔 때 UI가 화면 밖으로 밀려나거나 잘리는 레이아웃 버그가 발생하고 있는가?

6.2. 폰트 한글 깨짐 및 아틀라스(Atlas) 누락 버그

[ ] TextMeshPro를 사용할 때 한글을 지원하지 않는 기본 폰트를 그대로 사용하거나 필요한 폰트 자산/아틀라스 설정을 누락하여, 게임 내 텍스트가 네모 박스(깨짐 현상)나 물음표로 출력되는 버그가 발생할 위험은 없는가?

6.3. 이벤트 리스너 중복 등록 및 메모리 누수 버그

[ ] 버튼 클릭 이벤트 등을 등록할 때 OnEnable()에서 AddListener를 사용하면서 대응하는 OnDisable()에서의 RemoveListener 해제 처리를 누락하여, 오브젝트가 활성화될 때마다 이벤트가 중복 호출되거나 메모리 누수(Memory Leak)가 발생하고 있는가?

6.4. 초기화되지 않은 컴포넌트 참조로 인한 NullReference 예외

[ ] PlayerUIController에서 GetComponentInChildren()을 통해 무기 컴포넌트를 캐싱할 때, 대상 오브젝트에 해당 컴포넌트가 존재하지 않거나 타이밍 문제로 _weapon이 null인 상태가 되어 Update()문 내의 RefreshMegazineUI()에서 NullReferenceException 에러가 터지고 있지는 않은가?