개발 중 흔히 마주치는 오류 정리

개발 중 흔히 마주치는 오류 정리 (Common Errors)

LangChain과 LangGraph로 무언가를 만들다 보면 가끔 낯선 오류 메시지에 부딪히게 돼요. 이 페이지는 그런 흔한 오류를 해결하기 위한 가이드를 한곳에 모아둔 건데요. 코드에서 오류가 던져질 때는 lc_error_code 속성에 아래 코드 중 하나가 함께 담겨서 나와요. 그래서 오류 코드만 봐도 어떤 문제인지 바로 감을 잡을 수 있답니다.

출처: 공식문서

오류 코드 살펴보기

LangGraph 계열 오류와 LangChain 계열 오류가 따로 정리되어 있어요. 각 오류 코드의 링크를 따라가면 해당 오류가 왜 발생하는지, 어떻게 고치면 되는지 상세한 해결 가이드를 볼 수 있어요.

LangGraph 오류 코드:

오류 코드	소속
`GRAPH_RECURSION_LIMIT`	langgraph
`INVALID_CHAT_HISTORY`	langgraph
`INVALID_CONCURRENT_GRAPH_UPDATE`	langgraph
`INVALID_GRAPH_NODE_RETURN_VALUE`	langgraph
`MISSING_CHECKPOINTER`	langgraph
`MULTIPLE_SUBGRAPHS`	langgraph

LangChain 오류 코드:

오류 코드	소속
`INVALID_PROMPT_INPUT`	langchain
`INVALID_TOOL_RESULTS`	langchain
`MESSAGE_COERCION_FAILURE`	langchain
`MODEL_AUTHENTICATION`	langchain
`MODEL_NOT_FOUND`	langchain
`MODEL_RATE_LIMIT`	langchain
`OUTPUT_PARSING_FAILURE`	langchain

더 알아보기 (Learn more)

각 오류 코드의 문서 링크를 따라가면 원인과 해결 방법을 자세히 확인할 수 있어요. 특히 모델 호출(인증·미발견·요청 한도)과 출력 파싱 관련 오류는 실무에서 가장 자주 만나는 편이니 참고해 두면 좋아요.