디버깅 (Debugging)
코드에서 발생한 오류(버그)의 원인을 찾아내고 수정하는 과정입니다.
같은 말:Debugging오류 해결에러 수정문제 해결
🤔 혹시 이런 경험 있나요?
AI가 만들어준 코드를 복사해서 붙여넣었는데 화면에 아무것도 나오지 않습니다. 또는 빨간 에러 메시지가 잔뜩 뜨는데 뭔 말인지 하나도 모르겠습니다. AI에게 "에러 났어 고쳐줘"라고 했더니 또 다른 에러가 생깁니다. 이런 상황에서 필요한 것이 바로 디버깅입니다.
🐛 디버깅이란?
디버깅(Debugging)은 코드에서 발생한 오류(버그, Bug)의 원인을 찾아내고 수정하는 과정입니다. 버그는 오류를 뜻하며 오류 메시지가 없어도 잘못된 계산이나 저장 결과가 버그일 수 있습니다.
바이브코딩에서는 AI가 코드를 작성하지만, 에러가 발생했을 때 문제의 원인을 이해하고 AI에게 정확한 맥락을 전달하는 것은 여러분의 역할입니다. 기대 결과와 실제 결과를 나누면 어떤 부분을 조사할지 정하기 쉬워집니다.
🔴 에러 메시지 읽는 법
에러 메시지가 무섭게 보여도, 대부분 일정한 구조를 따릅니다.
TypeError: Cannot read properties of undefined (reading 'map')
at UserList (src/components/UserList.tsx:15:23)
at renderWithHooks (react-dom.development.js:14985:18)이 메시지에서 읽어야 할 핵심은 세 가지입니다.
- 에러 종류:
TypeError- 데이터 타입이 맞지 않는 문제입니다. - 에러 내용:
Cannot read properties of undefined- 값이 정해지지 않은 undefined에서 map이라는 속성을 읽으려 했습니다. - 에러 위치:
UserList.tsx:15:23- UserList 파일의 15번째 줄, 23번째 글자 근처입니다.
표시된 위치는 오류가 드러난 곳이며 원인은 앞선 데이터 처리에 있을 수도 있습니다. 파일명과 줄 번호는 실제 코드와 대조합니다. 모든 메시지에 이 정보가 있는 것은 아닙니다.
🔧 디버깅의 기본 도구들
1. console.log - 가장 간단한 디버깅
코드가 어디까지 실행되는지, 변수에 어떤 값이 들어 있는지 확인하는 가장 기본적인 방법입니다.
값 전체 대신 확인에 필요한 상태를 기록할 수 있습니다. 다음은 코드의 뜻을 읽는 예시이며 이 글에서 실행할 API는 아닙니다.
async function getUsers() {
const response = await fetch('/api/users')
console.log('응답 상태:', response.status)
if (!response.ok) throw new Error(`조회 실패: ${response.status}`)
const data = await response.json()
console.log('배열 여부:', Array.isArray(data))
return data
}응답 상태와 예상 자료형을 구분합니다. 서버가 404나 500을 보내도 fetch 자체가 자동으로 실패 예외를 던지는 것은 아닙니다. 이 예시는 JSON 본문을 주는 사용자 목록 API를 가정하며, 본문 없는 응답에는 다른 처리가 필요합니다. 로그에 비밀 키나 사용자 정보 전체를 출력하지 않습니다.
출력 하나가 없다는 이유만으로 특정 줄을 원인이라고 단정하지 않습니다. 요청이 아직 진행 중인지와 실행 분기 및 필터링된 로그도 확인합니다.
2. 브라우저 개발자 도구 (DevTools)
Chrome에서는 메뉴의 도구 더보기에서 개발자 도구를 열 수 있습니다. Windows의 F12 또는 Mac의 Option + Command + I도 사용할 수 있습니다.
- Console 탭:
console.log의 출력과 에러 메시지를 확인합니다. - Network 탭: API 요청이 성공했는지, 어떤 데이터가 오갔는지 확인합니다.
- Elements 탭: HTML 구조가 올바른지 확인합니다.
특히 Network 탭은 API 관련 문제를 해결할 때 매우 유용합니다. 상태 코드가 404인지, 401인지, 500인지 확인하고 응답 내용으로 원인을 좁힙니다. 예를 들어 404는 주소가 틀렸거나 해당 자료가 없을 수 있습니다.
3. 터미널 로그
서버 코드의 오류는 개발 서버를 실행한 터미널이나 배포 서비스의 서버 로그에서 확인합니다. 프로젝트가 npm run dev로 서버를 실행한다면 그 창을 봅니다. 브라우저에 일부 오류가 함께 표시되더라도 서버 로그를 별도로 확인합니다.
📝 흔한 에러 유형과 해결법
| 에러 유형 | 의미 | 흔한 원인 |
|---|---|---|
| SyntaxError | 문법 오류 | 괄호, 쉼표, 따옴표 누락 |
| TypeError | 타입 불일치 | undefined 값에 접근 |
| ReferenceError | 존재하지 않는 변수 | 오타, import 누락 |
| NetworkError | 네트워크 문제 | API URL 오류, 서버 미응답 |
| CORS Error | 다른 출처의 응답 접근 제한 | 서버의 허용 출처와 인증 조건 불일치 등 |
출처(origin)는 프로토콜과 호스트 및 포트의 조합입니다. 같은 도메인도 포트가 다르면 출처가 달라질 수 있습니다. CORS Error는 브라우저가 다른 출처의 응답을 읽을 수 있도록 서버가 허용하는 정책과 관련됩니다. 다른 도메인이라고 항상 차단되는 것은 아닙니다. 허용할 출처와 인증 조건을 확인하며 브라우저 보안 기능을 끄거나 모든 출처를 무조건 허용하는 것으로 해결하지 않습니다.
💡 AI에게 디버깅을 잘 맡기는 방법
AI에게 단순히 "에러 났어"라고 하면 정확한 답을 얻기 어렵습니다. 다음 정보를 함께 전달하면 원인을 조사하는 데 도움이 됩니다.
1. 관련 에러 메시지 (비밀 값과 개인정보를 가린 뒤 전달)
2. 관련 파일과 코드 중 필요한 부분 (비밀 값과 개인정보 제외)
3. 기대 결과와 실제 결과 및 재현 순서 (언제, 어떤 버튼 클릭 시 등)
4. 이미 시도한 해결 방법
5. 최근에 변경한 코드가 있다면 그 내용예를 들어 "로그인 버튼을 누르면 TypeError: Cannot read properties of undefined (reading 'email')이 뜹니다. LoginForm.tsx 23번째 줄이 문제 같습니다"라고 전달하면, AI가 조사할 위치를 좁히는 데 도움이 됩니다. 수정안은 실제 실행 결과로 검증해야 합니다.
본문 개념을 설명하는 학습용 예시입니다. 실제 서비스 화면이 아닙니다.
💼 디버깅 지식이 필요해지는 순간들
오픈 직전 이벤트 페이지의 버튼이 안 눌릴 때
캠페인 시작 몇 시간 전, 참여 버튼을 눌러도 아무 반응이 없는 것을 발견하는 상황입니다. F12로 개발자 도구를 열고 Console 탭을 확인하면 빨간 에러 메시지가 남아 있는 경우가 많습니다. 비밀 정보를 가린 메시지와 재현 순서를 개발자나 AI에게 전달하면, "버튼이 안 눌려요"라고만 말할 때보다 조사할 조건이 분명해집니다.
클릭 데이터가 GA4에 안 잡힐 때
버튼 클릭 이벤트를 심었는데 GA4에 숫자가 안 들어오는 경우, Network 탭에서 수집 요청이 실제로 나가는지 확인할 수 있습니다. 요청이 없다면 태그 조건과 동의 설정, 확장 프로그램에 의한 차단 등을 확인합니다. 요청이 있다면 대상과 매개변수, 수집 응답 및 보고서 반영 시점도 봅니다. 요청 전송만으로 올바른 집계가 보장되지는 않습니다. 이렇게 문제를 반으로 나눠가며 좁히는 방식이 디버깅의 기본입니다.
AI가 같은 에러를 계속 수정하지 못할 때
"에러 고쳐줘"를 반복해도 AI가 계속 엉뚱한 곳을 수정하며 헤매는 경우가 있습니다. 이때 에러 메시지에서 파일명과 줄 번호를 직접 읽고 "이 파일 이 줄에서 나는 에러야"라고 짚어주면 AI의 수정 정확도가 올라갑니다. 수정 전 상태를 Git으로 저장해두면, 기록한 코드 상태와 비교할 수 있습니다. 커밋하지 않은 변경이나 외부 데이터까지 자동 복구되지는 않습니다.
📝 계산 결과가 틀린 이유 찾기
설치 없이 메모장에서 다음 코드를 읽고 계산기로 결과를 비교합니다. 직접 실행하려면 npm 수업의 별도 연습 폴더에 있는 hello.js 내용을 보관한 뒤 아래 코드로 바꿔 npm start를 실행할 수 있습니다.
const price = 1000;
const quantity = 2;
const total = price + quantity;
console.log(total);물 한 병이 1,000원이고 두 병이면 기대 금액은 2,000원입니다. 그런데 이 코드는 덧셈을 해서 1,002를 출력합니다. 오류 메시지가 없어도 결과는 틀렸습니다.
AI에게 “기대 2000, 실제 1002이며 가격과 수량을 더하고 있어요. 필요한 줄만 수정하고 이유를 설명해 줘”라고 요청할 수 있습니다. 덧셈 기호를 곱셈 기호 *로 고치면 같은 조건에서 2000이 됩니다.
이번에는 quantity만 3으로 바꿉니다. 기대 결과는 3000입니다. AI가 total을 숫자 2000으로 고정했다면 이 두 번째 조건에서 실패합니다. 원인과 수정한 줄, 두 조건의 결과를 남기면 연습을 마친 것입니다. 직접 실행할 때 이전 값이 나오면 파일 저장과 실행 폴더를 확인합니다.
📋 3줄 요약
-
디버깅은 기대 결과와 실제 결과를 비교해 오류 원인을 좁히고 수정 결과를 다시 확인하는 과정입니다.
-
오류 메시지의 종류와 내용 및 위치는 조사 단서이며 표시된 줄이 항상 원인인 것은 아닙니다.
-
비밀을 가린 재현 정보와 로그를 전달하고 수정 뒤 같은 조건과 다른 조건을 모두 확인합니다.
📚 참고 자료
공식 문서 확인: 2026년 10월 3일.

제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
AI가 만든 앱의 오류 원인을 조사하려고 합니다. 도움을 요청할 때 가장 알맞은 방법은 무엇인가요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.

