Roblox Studio에서 스크립트를 시작하면 가장 자주 만나는 단어 중 하나가 nil입니다. “attempt to index nil”, “nil value” 같은 메시지가 뜨면 코드가 전부 틀렸다고 느끼기 쉽지만, 대부분은 기대한 객체나 값이 그 시점에 존재하지 않는다는 뜻에서 출발합니다. Output 메시지를 위에서부터 읽는 습관만 잡아도 디버깅 시간이 크게 줄어듭니다.
1. 오류 문장보다 파일과 줄 번호를 먼저 봅니다
Output에는 어떤 Script나 ModuleScript의 몇 번째 줄에서 문제가 발생했는지 표시됩니다. 같은 이름의 변수가 여러 곳에 있어도 줄 번호를 따라가면 실제로 실패한 표현식을 바로 찾을 수 있습니다. 오류가 여러 개라면 가장 먼저 발생한 오류부터 해결하는 것이 좋습니다. 첫 오류 때문에 뒤에 수십 개가 연쇄적으로 생길 수 있기 때문입니다.
2. 점 앞의 값이 nil인지 확인합니다
예를 들어 player.Character.Humanoid 같은 코드에서 오류가 난다면 무조건 Humanoid가 문제라고 단정하지 마세요. player, Character, Humanoid 중 어느 단계가 nil인지 나눠서 확인해야 합니다. 중간 값을 print하거나 변수로 따로 빼면 어디서 끊겼는지 쉽게 알 수 있습니다.
3. FindFirstChild와 WaitForChild를 목적에 맞게 사용합니다
객체가 없을 수도 있는 상황이면 FindFirstChild로 존재 여부를 확인할 수 있습니다. 반대로 복제 과정 때문에 잠시 뒤 생기는 객체를 기다려야 한다면 WaitForChild가 맞을 수 있습니다. 다만 영원히 생기지 않을 객체를 무작정 기다리지 않도록 구조와 타이밍을 같이 확인해야 합니다.
4. 캐릭터는 재생성된다는 점을 기억합니다
플레이어가 죽고 다시 스폰하면 Character 객체가 바뀝니다. 게임 시작 때 한 번 저장한 Character 참조를 계속 쓰면 나중에 nil이나 파괴된 객체 관련 문제가 생길 수 있습니다. CharacterAdded 같은 이벤트를 이용해 새 캐릭터 기준으로 다시 연결해야 하는 기능인지 확인하세요.
5. 클라이언트와 서버에서 보이는 객체가 다를 수 있습니다
ServerStorage처럼 클라이언트가 볼 수 없는 위치의 객체를 LocalScript에서 찾으면 원하는 값이 나오지 않습니다. 반대로 PlayerGui처럼 플레이어별로 생기는 객체를 서버 코드에서 다룰 때도 시점을 잘 봐야 합니다. Studio의 Client/Server 전환으로 실제로 어느 쪽에 객체가 있는지 확인해 보세요.
6. 변수 이름 오타와 대소문자를 확인합니다
Luau에서 이름이 비슷하다고 같은 변수로 처리되지 않습니다. 변수명, 자식 이름, 속성 이름의 철자가 정확한지 확인하세요. Explorer에서 객체 이름을 복사해 비교하면 단순 오타를 빨리 찾을 수 있습니다.
7. 함수가 값을 반환하지 않는지도 봅니다
어떤 함수가 값을 돌려줄 거라고 생각했는데 return이 없으면 결과는 nil이 될 수 있습니다. 함수 내부 조건문 중 특정 경로에서만 return이 빠지는 경우도 흔합니다. 호출 결과를 바로 사용하기 전에 실제 반환값을 출력해보세요.
디버깅 순서
Output 첫 오류 → 파일과 줄 번호 → 점 앞의 값들을 하나씩 확인 → 객체가 존재하는 위치와 생성 시점 확인 → 변수와 return 확인 순서로 보면 됩니다. nil은 원인이 아니라 “여기에서 기대한 값이 없었다”는 신호입니다. 그 값이 왜 없었는지를 찾는 것이 디버깅의 핵심입니다.
print를 지우기 전에 원인을 확실히 확인합니다
디버깅용 print를 추가했다가 값이 한 번 정상으로 나온다고 바로 지우지 말고 사망, 재접속, 두 번째 실행에서도 같은지 확인하세요. nil 오류는 특정 타이밍에서만 생기는 경우가 많기 때문에 첫 테스트에서 재현되지 않을 수 있습니다. 문제가 해결된 뒤에는 불필요한 로그를 정리해 Output이 실제 오류를 보기 어렵게 만들지 않도록 합니다.