▶ 디버깅·오류 해결

🖐 실무 따라하기 — 복붙해서 따라 하면 됩니다

1. 1재현 — 오류를 눈앞에서 다시 낸다

   실습용 폴더를 만들고, 아래 두 파일을 그대로 만든다. 먼저 합성 데이터 minwon.csv(개인정보는 전부 가짜)를 저장하고, 이어서 집계 스크립트 tally.py를 저장한다. 그다음 python3 tally.py로 실행해 '오류가 실제로 나는 것'을 먼저 확인한다. (고치기 전에 재현부터 하는 이유: 재현 안 되는 버그는 고쳤는지 확인할 수 없다.)

   터미널 명령

   ⧉ 복사

   # 1) 데이터 파일 생성 (터미널에 그대로 붙여넣기)
   cat > minwon.csv <<'CSV'
   접수번호,민원인,연락처,처리기간(일)
   MW-2026-0001,홍길동,010-0000-0000,10
   MW-2026-0002,김철수,010-0000-0000,
   MW-2026-0003,이영희,010-0000-0000,14
   MW-2026-0004,박민수,010-0000-0000,미접수
   MW-2026-0005,최지현,010-0000-0000,15
   CSV
   
   # 2) 집계 스크립트 생성
   cat > tally.py <<'PY'
   import csv
   
   total = 0
   count = 0
   with open("minwon.csv", newline="", encoding="utf-8") as f:
       for row in csv.DictReader(f):
           days = int(row["처리기간(일)"])   # <-- 여기서 죽는다
           total += days
           count += 1
   
   print("평균 처리기간:", total / count, "일")
   PY
   
   # 3) 실행
   python3 tally.py

   → 결과 빨간 Traceback이 출력되고 마지막 줄에 대략 'ValueError: invalid literal for int() with base 10: ''(빈 값)가 뜬다. 위쪽 스택에 File "tally.py", line 8, in <module> / days = int(row["처리기간(일)"]) 가 보인다 → 오류가 실제로 재현됨을 확인. (참고: 앞의 두 cat 블록은 파일만 만들고 화면에 아무 출력도 없는 게 정상이다. 내용 확인은 cat minwon.csv / cat tally.py로.)

2. 2스택 트레이스에서 '내 줄' 찾기

   Traceback을 아래→위로 읽는다. 맨 아래는 '오류 종류'(ValueError…), 그 위 블록들은 '어느 파일 몇 번째 줄'인지다. 남의 라이브러리(csv 등) 줄은 건너뛰고, 파일명이 tally.py인 줄 = 내가 고칠 줄을 찾는다. 여기서는 line 8의 days = int(...) 이다. 셸에서 그 줄만 뽑아 눈으로 확인한다.

   터미널 명령

   ⧉ 복사

   # tally.py의 8번째 줄만 번호와 함께 출력해서 '내 줄' 확인
   nl -ba tally.py | sed -n '8p'

   → 결과 '8 days = int(row["처리기간(일)"])' 처럼 8번 줄이 표시된다. 이 줄이 스택 트레이스가 가리킨 '내 코드 줄'이며, 문자열을 int()로 강제 변환하는 지점이 범인 후보임을 특정.

3. 3격리 — 이분탐색으로 '어느 행'이 죽이는지 좁힌다

   원인이 데이터의 어느 행인지 모를 때는 절반씩 잘라 실행한다. 먼저 위 절반(1~2행)만, 죽으면 그 절반 안에, 안 죽으면 아래 절반에 원인이 있다. 아래 명령은 헤더+처음 N개 데이터행만 임시 파일로 만들어 돌려보는 방식이다. head 개수를 3→5로 바꿔가며 어느 행 추가 시 죽는지 좁힌다.

   터미널 명령

   ⧉ 복사

   # 헤더 포함 위에서 3줄(=데이터 2행)만 남겨 실행 → 죽는지 본다
   head -n 3 minwon.csv > _probe.csv
   python3 - <<'PY'
   import csv
   for row in csv.DictReader(open("_probe.csv", encoding="utf-8")):
       print(row["접수번호"], "->", repr(row["처리기간(일)"]), "| int 변환:", end=" ")
       try:
           print(int(row["처리기간(일)"]))
       except Exception as e:
           print("실패:", type(e).__name__, e)
   PY

   → 결과 MW-2026-0001은 10으로 변환 성공, MW-2026-0002는 값이 '' (빈칸)이라 '실패: ValueError'로 출력된다. head 개수를 5로 늘리면 MW-2026-0004의 '미접수'도 실패. → 죽이는 행은 '빈칸' 행과 '미접수'(숫자 아님) 행 두 종류로 격리 완료.

4. 4비식별 후 AI에 질문 (개인정보 제거가 핵심)

   이제 AI에 물어 고친다. 단, 원본 CSV·로그를 그대로 붙이지 말 것. 아래 프롬프트는 이미 이름·연락처를 가짜로 바꾸고 개인정보 컬럼을 뺀 '최소 재현 예시'만 담았다. 이 전문을 ChatGPT 또는 Claude 웹에 그대로 붙여넣는다. (맥락=오류 메시지+내 줄+격리 결과를 함께 줘야 AI가 정확히 답한다.)

   프롬프트 (복사해서 AI에 입력)

   ⧉ 복사

   파이썬 초급자입니다. 아래 CSV 집계 코드가 특정 행에서 ValueError로 멈춥니다. 원인과 수정 코드를 알려주세요.
   
   [상황] '처리기간(일)' 열의 평균을 구하려 합니다. 그런데 이 열에는 빈칸('')이나 숫자가 아닌 값('미접수')이 섞여 있습니다.
   
   [오류] ValueError: invalid literal for int() with base 10: ''
   [내 코드 줄] days = int(row["처리기간(일)"])
   
   [비식별 최소 재현 데이터] (실제 민원인 정보 아님, 합성)
   접수번호,처리기간(일)
   MW-2026-0001,10
   MW-2026-0002,
   MW-2026-0003,14
   MW-2026-0004,미접수
   MW-2026-0005,15
   
   [요구사항]
   1. 빈칸/'미접수' 같은 비숫자 값은 평균 계산에서 제외(결측 처리)할 것.
   2. 제외한 건수도 함께 세어 출력할 것.
   3. 초급자용으로 주석 달고, try/except로 안전하게 처리한 전체 코드로 줄 것.

   → 결과 AI가 원인을 '빈 문자열/문자값을 int()로 변환 불가'로 설명하고, int() 대신 try/except 또는 값 검사로 건너뛰는 수정 코드를 준다. 주의: AI가 float() 사용·컬럼명 오타·결측 개수 미출력 등 요구를 일부 빠뜨릴 수 있으니 다음 step에서 반드시 실행 검증.

5. 5수정 적용 — 안전하게 건너뛰는 코드로 교체

   AI 답을 그대로 믿지 말고, 우리 요구(결측 개수 출력·나눗셈 0 방지)를 충족하는 검증된 버전으로 tally.py를 통째로 덮어쓴다. 아래는 그 최소 정답 코드다. (AI가 준 코드와 비교해 빠진 요구사항이 있으면 이쪽을 기준으로 삼는다.)

   터미널 명령

   ⧉ 복사

   cat > tally.py <<'PY'
   import csv
   
   total = 0          # 유효 처리기간 합
   count = 0          # 유효 건수
   skipped = 0        # 빈칸/비숫자로 제외한 건수
   
   with open("minwon.csv", newline="", encoding="utf-8") as f:
       for row in csv.DictReader(f):
           value = row["처리기간(일)"].strip()
           try:
               days = int(value)          # 숫자면 성공
           except ValueError:
               skipped += 1               # 빈칸('')·'미접수' 등은 건너뜀
               continue
           total += days
           count += 1
   
   if count == 0:
       print("평균 처리기간: 계산 불가 (유효 데이터 0건)")
   else:
       avg = total / count
       print(f"평균 처리기간: {avg:.1f}일 (유효 데이터 {count}건, 결측 {skipped}건 제외)")
   PY

   → 결과 명령이 조용히 끝나며(오류 없음, 화면 출력 없음이 정상) tally.py가 새 내용으로 교체된다. int() 대신 try/except로 감쌌고, count==0일 때 0으로 나누는 사고도 막았음을 코드에서 확인. 내용 확인은 cat tally.py.

6. 6재검증 — 고쳐졌는지 + 회귀(멀쩡하던 것 안 깨졌는지) 확인

   수정본을 실행해 오류 없이 결과가 나오는지 본다. 그리고 '숫자만 있는 정상 데이터'에서도 여전히 옳은 평균을 내는지(회귀 확인) 별도 데이터로 한 번 더 돌린다. 반려 민원을 보완해 재접수했으면 접수처가 다시 검토하듯, 고친 코드는 원래 케이스와 새 케이스를 둘 다 통과해야 한다.

   터미널 명령

   ⧉ 복사

   # 1) 원래 문제 데이터로 재실행 (고쳐졌는지)
   python3 tally.py
   
   # 2) 회귀 확인: 숫자만 있는 정상 데이터로도 맞는지
   cat > minwon.csv <<'CSV'
   접수번호,민원인,연락처,처리기간(일)
   MW-2026-0001,홍길동,010-0000-0000,10
   MW-2026-0002,김철수,010-0000-0000,20
   CSV
   python3 tally.py

   → 결과 1) '평균 처리기간: 13.0일 (유효 데이터 3건, 결측 2건 제외)' 가 오류 없이 출력(원래 문제 해결). 2) 정상 데이터에서는 '평균 처리기간: 15.0일 (유효 데이터 2건, 결측 0건 제외)' 로 정확한 평균을 내며, 결측 처리 로직이 정상 데이터를 망가뜨리지 않음(회귀 없음)을 확인 → 완주.