21차시. 첫 번째 LangGraph 실습
10. 자주 겪는 문제
출처: 원본 PDF 21차시_첫번째LangGraph실습.pdf 18쪽 · 쪽 그림 18쪽
| 증상 | 원인과 해결 |
|---|---|
| ValueError: Node 'generate' not found | add_node 이름과 add_edge 문자열이 다릅니다. 오타 확인 |
| KeyError: 'retry' (경로맵에 없음) | 판단 함수가 낼 수 있는 모든 값을 경로맵에 넣으세요 |
| GraphRecursionError | 무한루프입니다. 상한 검사 위치와 bump 노드를 확인하세요 |
| compile() 없이 invoke 호출 | 그래프는 compile() 후에야 실행 가능한 앱이 됩니다 |
| KeyError: 'documents' (노드 안에서) | init에서 모든 키를 채우거나 .get()으로 읽으세요 |
| 루프가 안 도는데 결과가 이상함 | stream으로 실제 경로를 확인하세요 |
10-1) GraphRecursionError를 만났다면
🔍 확인 순서
① 판단 함수에서 상한 검사가 맨 위에 있는가
다른 조건에 먼저 걸리면 상한이 무시됩니다
② bump 노드가 루프 경로에 들어 있는가
카운터가 안 올라가면 상한에 영원히 도달 못 합니다
③ bump가 retries를 실제로 반환하는가
print만 하고 반환을 빠뜨린 경우가 흔합니다
④ State에 retries 초기값이 있는가
없으면 .get()의 기본값 0이 매번 반환됩니다
네 가지를 순서대로 확인하면 대개 찾아집니다.