이번 차시에서 배우는 것

출처: 원본 PDF 31차시_방어적코딩실습.pdf 1쪽 · 쪽 그림 1쪽

예외 처리 설계 — 어떤 상황에서도 죽지 않기

✓ 시스템의 실패 지점을 빠짐없이 목록화한다 ✓ 부분 실패를 허용하는 설계를 이해한다 ✓ Fallback을 상황별로 계층화한다
✓ 사용자에게 불확실성을 정직하게 알린다 ✓ 타임아웃과 재시도 정책을 설정한다
✓ 운영에 필요한 로그를 남긴다

교안 해설: 이 시간에 하는 일

출처: 교안 31_예외처리설계.md

노드가 늘면 실패 지점도 늘습니다. 분류의 형식 오류, 인덱스가 없음, 모델 호출 한도, 검증 JSON 파싱 실패가 각각 납니다. 예외가 그래프 밖으로 나가면 사용자에게는 빈 실패만 남습니다.

safe.py는 노드 함수를 감싸 예외가 나도 그 노드용 기본 State를 돌려주고 오류 문자열을 남깁니다. 이 파일은 실제로 실행했습니다. 정상 반환과 일부러 낸 오류가 샘플에 있습니다. 모든 예외를 삼키기만 하면 조용한 실패가 됩니다. 로그에 종류와 위치가 있어야 합니다.

analyze_logs.py는 logs/queries.jsonl을 집계합니다. 원본 로그 6건을 실행한 결과 통과율 67%, 재작성 17%, 평균 약 1.9초, 오류 0이었습니다. logger.py는 실행하면 로그 파일을 추가하므로 실행하지 않았습니다. 안내 문장은 '못 찾음'과 '요청이 많음'을 나누어 사용자가 다음에 할 일을 다르게 알게 합니다.

강의 PPT 흐름

출처: 강의 PPT 31차시_예외처리설계.pptx (21장)