언제 쓰나
에러가 터졌는데 스택 트레이스가 길고 어디서부터 봐야 할지 막막할 때.
"이게 내 코드 문제인지, 라이브러리 문제인지, 환경 문제인지" 먼저 가려야 할 때.
흐름 한눈에 보기
flowchart LR
A["📋 에러 메시지\n스택 트레이스"] --> B{"에러 유형\n분류"}
B --> C["Syntax / Type"]
B --> D["Runtime"]
B --> E["Logic"]
C --> F["즉시 수정 가능"]
D --> G["원인 가설\n1·2순위"]
E --> H["재현 조건\n파악 필요"]
F --> I["✅ 수정 코드\n+ 재발 방지"]
G --> I
H --> I
프롬프트 (복사)
당신은 시니어 개발자입니다. 아래 에러를 분석해 주세요.
**환경**
- 언어 / 프레임워크: [예: Python 3.11 / FastAPI]
- 실행 방법: [예: uvicorn main:app --reload]
- 최근 변경 사항: [예: 패키지 업데이트, 코드 수정 내용]
**에러 메시지 전체**
[스택 트레이스 또는 에러 로그 전체 붙여 넣기]
**에러 직전에 한 일**
[예: 특정 API 호출, DB 조회, 파일 읽기 등]
**관련 코드** (선택)
[에러 발생 위치 전후 10~20줄]
---
다음 형식으로만 답해 주세요.
1. **원인 가설** — 가능성 높은 순으로 2가지, 각 1~2문장. 근거 없는 추측은 포함하지 마세요.
2. **지금 당장 확인할 것** — 3가지 이내. 확인 명령어나 코드를 함께 적어 주세요.
3. **수정 예시 코드** — 가설 1순위 기준. before / after 형식으로.
4. **재발 방지 팁** — 1~2줄.
칭찬·서론은 생략하고 바로 분석 결과만 주세요.
잘 쓰는 팁
- 환경 정보를 빠뜨리지 마세요. 같은 에러라도 Python 3.9와 3.12에서 원인이 다를 수 있습니다.
- 에러가 간헐적으로 발생한다면 "재현 조건"에 빈도·타이밍을 적으세요. Logic 에러일 확률이 높습니다.
- 수정 후 같은 에러가 다시 나면 "가설 1순위는 틀렸습니다. 가설 2순위로 다시 분석해 주세요"라고 이어 말하면 됩니다.