왜 LangGraph 도입 후 코드가 더 복잡해졌나 — 실패에서 배운 기록

한 줄 요약

LangGraph를 도입했으나 오히려 코드가 복잡해진 경험기와 개선 방법.

핵심 내용

• 상태 관리와 흐름 제어가 깔끔해질 거라는 기대로 LangGraph 도입

• 그래프에 노드가 하나뿐인 단순 구조에서 조건부 엣지나 분기 없음

• 같은 상태를 LangGraph MemorySaver와 PostgreSQL Checkpointer에 중복 저장하면서 불일치 발생

• 8,700줄 코드 중 실질 핵심은 "LLM 호출 + 프롬프트 조립"에 불과하고 대부분 상태 관리·조건 분기

• 원인: 검증 없는 바이브 코딩으로 부분 최적화가 누적, 설계자가 프레임워크 의도를 충분히 이해하지 못함

• 해결: 독립 토폴로지 분리, State를 메타만으로, regex 대신 tool_use 사용, 테스트 가능하도록 노드 분리

왜 중요한가

프레임워크 도입이 항상 구조를 나아지게 하지는 않는다는 교훈. 기술 선택이 아니라 설계와 검증의 부재가 복잡성을 키웠고, 프레임워크를 "어떻게 쓸지"가 아니라 "어떻게 잘못 썼는지"를 정리한 실전 사례.

참조한 것 · 가져온 것

• 원문: https://neocode24.com/blog/langgraph-spaghetti-lessons-from-failure

• GeekNews: https://news.hada.io/topic?id=31628