결과 예시
"data 는 값이 있고 data.items 만 비어 있다"는 해석이 먼저 나왔다. 에러가 'items'가 아니라 'map'에서 났다는 점을 근거로 삼았다.
| 원인 후보 | 근거 | 확인 방법 |
|---|---|---|
| 응답 JSON 키가 items 가 아님 | 'map'에서 난 에러 | 24행 위에서 Object.keys(data) 출력 |
| 첫 렌더에 빈 객체가 넘어옴 | 호출부 코드가 자료에 없음 | 이 컴포넌트를 부르는 곳의 data 값 확인 |
호출부 파일까지 함께 붙이면 후보가 더 좁혀진다.
Claude에서 실제로 실행해 확인 · 2026-09
왜 이렇게 쓰는가
에러 해결 chatgpt 사용에서 가장 흔한 실수는 빨간 글씨만 복사해 던져 넣는 것입니다. 같은 메시지도 언어와 버전에 따라 원인이 전혀 다르기 때문에, 환경을 모르는 AI는 가장 유명한 원인 하나를 단정하고 엉뚱한 해결책부터 시키게 됩니다.
맥락 문단이 그 단정을 막습니다. 프레임워크와 버전, 운영체제를 적어 주면 지금 쓰지 않는 설정을 고치라는 답이 사라집니다. "이 코드를 오늘 처음 본다"는 한마디는 설명의 깊이도 함께 정해 줍니다.
과제에서 원인을 "3개까지, 가능성이 높은 순서로" 받는 이유는 디버깅이 대부분 소거법이기 때문입니다. 하나만 받으면 그것이 틀렸을 때 다시 처음으로 돌아가지만, 셋을 받으면 다음 후보로 넘어갈 수 있습니다. 이어지는 단계별 확인 순서는 AI가 원인 설명만 늘어놓지 않고 제가 지금 누를 수 있는 행동으로 답하게 만듭니다.
형식의 표는 근거 열이 핵심입니다. 근거를 쓰게 하면 스택 트레이스에 실제로 있는 단서와 일반론을 구분할 수 있습니다. 이런 디버깅 프롬프트에서 자료를 """ 로 감싸는 것도 중요합니다. 에러 로그에는 따옴표와 줄바꿈, 때로는 문장처럼 보이는 안내문이 섞여 있어서, 구분해 주지 않으면 AI가 로그의 일부를 제 지시로 읽습니다.
관련 코드를 따로 받는 것도 일부러입니다. 에러 메시지는 어디서 터졌는지만 알려 주고 왜 그 값이 비어 있었는지는 말해 주지 않습니다. 스택 트레이스가 가리키는 줄과 그 주변을 함께 넣어야 원인 후보가 일반론에서 제 코드 이야기로 바뀝니다.
용어가 낯설면 아하AI에서: prompt, hallucination
나쁜 예와 비교
이 에러 왜 나는지 알려줘
TypeError: Cannot read properties of undefined (reading 'map')
가장 흔한 원인 하나를 단정한 뒤 그에 맞는 수정 코드를 바로 내놓습니다. 코드를 함께 주지 않았으니 그 코드는 제 파일과 이름부터 다르고, 붙여 넣어도 다른 에러가 납니다. 확인 순서가 없어서 틀렸을 때 다음에 무엇을 볼지도 남지 않고, 결국 같은 질문을 표현만 바꿔 다시 하게 됩니다.
변형
에러 없이 결과만 이상할 때
저는 {{실행 환경}}에서 작업 중이고, 에러는 나지 않는데 결과가 기대와 다릅니다. 아래 코드에서 값이 어떻게 흘러가는지 한 단계씩 따라가며, 제가 기대한 결과와 갈라지는 지점이 어디인지 찾아 주세요. 각 단계에서 변수에 무엇이 들어 있을지 함께 적어 주세요.
""" {{관련 코드}} """
멈추지 않고 조용히 틀리는 경우에 씁니다. 에러 메시지가 없으니 값의 흐름을 따라가게 하는 것이 유일한 단서입니다.
검색해도 안 나오는 에러일 때
아래 에러 메시지에서 검색에 쓸 만한 핵심 문구를 3개 뽑아 주세요. 제 프로젝트 이름·파일 경로처럼 저에게만 있는 부분은 빼고, 라이브러리 이름과 오류 종류가 남게 다듬어 주세요. 각 문구가 어떤 종류의 결과를 찾아 줄지도 한 줄씩 적어 주세요.
""" {{에러 메시지}} """
AI의 답이 미덥지 않을 때 검색으로 넘어가기 위한 단계입니다. 개인 경로가 섞인 문구로는 검색 결과가 나오지 않습니다.
모델별 주의
에러 메시지에 파일 경로나 사내 서버 주소가 들어 있으면 지우거나 바꾼 뒤 붙여 넣으세요
관련 프롬프트
마지막 수정 2026-09-02 · 잘못된 점이 있나요? 알려 주세요