AI 코딩 오류가 막막하다면 자바스크립트 콘솔부터 읽으세요
오류 메시지는 실패 판정이 아니라 위치 안내입니다
AI가 작성해도 실행은 브라우저가 담당합니다
AI가 만들어 준 버튼을 눌렀는데 아무 반응이 없나요? 같은 코드를 다시 만들어 달라고 요청하기 전에 자바스크립트 오류 메시지부터 확인하면, 어디서 동작이 멈췄는지 좁힐 수 있습니다. 오류의 종류와 발생 위치를 읽는 것이 출발점입니다.
AI 코딩 도구는 코드를 제안하고 수정하지만, 웹페이지의 자바스크립트를 실제로 실행하는 주체는 브라우저입니다. 시각적 구성과 적은 코드를 활용하는 방식은 로 코드 용어 항목에서 살펴볼 수 있습니다.
콘솔과 터미널은 확인할 문제가 다릅니다
웹페이지를 연 상태에서 브라우저의 개발자 도구를 열고 Console 탭을 선택합니다. 메뉴와 단축키는 환경마다 다르므로 브라우저 메뉴에서 개발자 도구를 찾으면 됩니다. 언어 자체가 낯설다면 자바스크립트 용어 항목을 참고하고, 지금은 아래처럼 화면별 역할부터 구분합니다.
- 브라우저 콘솔: 버튼 클릭이나 화면 갱신 과정에서 생긴 오류를 확인합니다.
- 터미널: 개발 서버 실행과 빌드 과정의 메시지를 확인합니다. 서버가 시작되지 않아 페이지에 접속하지 못한다면 터미널 출력부터 살펴봅니다.
- AI 대화창: 관찰한 증상을 설명하고 원인 후보를 받는 곳입니다. AI의 설명과 실제 실행 결과를 구분해서 읽어야 합니다.
빨간 글씨에서 종류와 설명, 파일 위치를 찾습니다
자주 만나는 오류 세 가지를 구별합니다
콘솔에 문장이 길게 나타나도 읽을 순서는 간단합니다. 오류 이름, 바로 뒤의 설명, 연결된 파일 위치를 순서대로 확인합니다. 아래 오류의 정확한 문구는 실행 환경에 따라 달라질 수 있습니다.
| 오류 종류 | 뜻과 예시 | 처음 확인할 부분 |
|---|---|---|
| SyntaxError | 문법을 해석하지 못한 상태입니다. 괄호나 따옴표가 빠졌을 때 나타날 수 있습니다. | 표시된 줄과 그 앞줄에서 괄호의 짝, 문자열의 끝을 확인합니다. |
| ReferenceError | 참조한 이름을 찾지 못한 경우 등이 해당합니다. userName을 선언하고 username을 사용했는지 살펴봅니다. | 변수 철자와 대소문자, 선언 위치와 사용할 수 있는 범위를 확인합니다. |
| TypeError | 현재 값으로 수행할 수 없는 작업을 시도한 상태입니다. null에서 속성을 읽으려는 경우가 한 예입니다. | 오류가 난 작업 직전의 값과 예상한 값의 형태가 같은지 확인합니다. |
오류가 표시된 줄과 원인이 생긴 줄은 다를 수 있습니다
예를 들어 app.js:24:9는 일반적으로 app.js의 24번째 줄, 9번째 열을 가리킵니다. 아래에 이어지는 함수 이름과 위치는 오류까지의 호출 경로인 호출 스택을 보여 줍니다. 다만 표시된 위치는 문제가 드러난 지점이므로, 실제 원인은 앞에서 잘못 전달한 값일 수도 있습니다.
- 증상과 연결된 메시지를 고릅니다. 동작 직후 생긴 오류와 다른 출처의 메시지를 구분합니다.
- 파일 링크를 누릅니다. 연결된 코드에서 어떤 변수와 작업이 등장하는지 확인합니다. 외부 라이브러리라면 호출 경로에서 내 파일도 찾아봅니다.
- 반복되는 오류를 묶어 읽습니다. 같은 오류가 여러 번 보인다고 원인도 여러 개라는 뜻은 아닙니다.
빨간 메시지가 없는데 결과가 틀릴 수도 있습니다. 합계가 30이어야 하는데 1020으로 표시된다면 문자열을 이어 붙인 것인지 값의 자료형을 확인해야 합니다. 이런 논리 오류를 찾으려면 실제 값과 기대한 값을 나란히 적습니다.
콘솔의 첫 번째 빨간 줄이 언제나 원인은 아닙니다. 내가 문제를 일으킨 동작과 같은 시점에 나타난 메시지인지 먼저 연결해 봅니다.
버튼 하나를 기준으로 원인 후보를 좁혀 봅니다
같은 오류를 다시 만드는 순서를 적습니다
연습 상황을 하나 가정하겠습니다. 저장 버튼이 있는 페이지에서 Cannot read properties of null과 addEventListener가 포함된 오류가 보입니다. 페이지 요소를 찾은 결과가 null인데 이벤트를 연결하려 했을 가능성이 있으므로, 바로 코드를 다시 생성하기보다 해당 줄이 어떤 대상을 찾았는지 확인합니다.
- 재현 순서를 고정합니다. 접속, 입력, 저장 버튼 클릭 순서를 적고 오류가 어느 단계에서 생기는지 구별합니다. 기존 메시지를 기록한 다음 콘솔을 비우고 같은 순서를 따라가면 새 오류를 찾기 쉽습니다.
- 실제 요소 이름을 대조합니다. 코드가 #save-button을 찾는데 HTML의 id가 saveButton이라면 서로 다른 이름입니다. 대소문자와 하이픈까지 비교하고, 해당 요소가 현재 화면에 있는지도 봅니다.
- 이름이 맞으면 실행 시점을 확인합니다. 버튼이 만들어지기 전에 코드가 실행되거나, 특정 화면에서만 버튼이 나타날 수 있습니다. 이때는 이름 변경보다 요소가 준비되는 시점을 살펴봐야 합니다.
- 한 가지 수정만 적용합니다. 이름 불일치가 확인됐다면 그 부분을 맞춘 뒤 같은 동작을 반복합니다. 여러 부분을 함께 바꾸면 무엇이 영향을 줬는지 판단하기 어렵습니다.
AI에는 수정 전에 확인할 근거를 요청합니다
“안 되니 고쳐 줘” 대신 예상 동작과 실제 동작, 오류 원문, 관련 코드를 전달합니다. 관련 코드에는 오류가 난 줄만 넣기보다 변수를 만든 부분과 버튼의 HTML도 함께 포함하는 편이 좋습니다.
저장 버튼을 누르면 완료 문구가 나와야 하지만 반응이 없습니다. 페이지를 열 때 app.js:24에서 null의 addEventListener를 읽지 못한다는 오류가 납니다. 아래 HTML과 요소를 찾는 코드를 보고 원인 후보, 각 후보의 확인 방법, 확인된 경우의 최소 수정안을 차례로 설명해 주세요.
수정 후에는 콘솔에서 오류가 사라졌는지와 완료 문구가 실제로 나오는지를 각각 확인합니다. 예를 들어 버튼을 찾지 못하면 그냥 넘어가도록 조건만 추가하면 오류는 숨겨져도 저장 기능은 여전히 동작하지 않을 수 있습니다. 오류 제거와 원하는 기능의 복구를 별도의 관찰 항목으로 두는 이유입니다.
오류를 숨긴 뒤 버튼까지 멈추는 실수를 피합니다
FAQ: 초보자가 콘솔을 열면 생기는 의문
오류가 많다고 유료 도구부터 찾을 필요는 없습니다. 이 글의 콘솔 확인과 재현 연습에는 별도의 유료 디버깅 서비스가 필요하지 않습니다. 관찰한 내용을 구체적으로 설명하는 것부터 연습합니다.
- Q. 영어 오류를 전부 번역해야 하나요? A. 오류 이름과 설명부터 해석합니다. 변수명과 파일명은 코드에서 찾을 수 있도록 원문을 보관합니다.
- Q. 경고도 모두 먼저 해결해야 하나요? A. 경고가 동작을 즉시 멈추지는 않을 수 있습니다. 현재 증상과 연결된 오류부터 조사하되 경고도 내용을 읽고 조치를 판단합니다.
- Q. 콘솔에 아무것도 없다면 어디를 보나요? A. 메시지 필터부터 확인합니다. 오류가 없다면 결과값과 이벤트 연결을 살펴보고, 서버 작업이 관련됐다면 터미널도 확인합니다.
조용해진 콘솔을 정상 동작으로 착각하지 않습니다
AI가 제시한 수정안은 “버튼의 id와 선택자를 일치시켰다”처럼 변경 이유를 설명해 보세요. 설명이 어렵다면 적용 전에 관련 변수와 실행 순서부터 다시 물어봅니다.
수정 전 파일을 복사하거나 버전 관리 도구에 기준 상태를 남겨 두면 되돌리기 편합니다. 아래 세 가지 실수도 화면의 반응으로 확인합니다.
- 예외를 삼키고 끝내기: 오류를 잡고 아무 처리도 하지 않으면 실패가 숨을 수 있습니다. 저장 실패를 성공처럼 표시하지 않는지 확인합니다.
- 기다리는 시간을 임의로 늘리기: 버튼을 기다리려고 일정 시간 뒤 실행하면 다른 환경에서 실패할 수 있습니다. 시간 추측보다 필요한 요소가 준비되는 조건을 확인합니다.
- 여러 곳을 바꾸고 한 번만 눌러 보기: 우연히 동작할 수 있습니다. 변경 범위를 줄이고 새로고침한 다음, 처음 오류가 났던 순서대로 버튼이 작동하는지 확인합니다.

- 다음글AI 코딩 테스트 자동화에서 놓치기 쉬운 실패와 함정 26.11.20
등록된 댓글이 없습니다.
