LangGraph.js(@langchain/langgraph)가 2026년 11월 9일 v1.7.3 패치를 릴리스했습니다. 공식 릴리스 노트와 풀 리퀘스트(PR #3090, OsamaAnsar 기여)에 따르면, 스트리밍 인터페이스 소비자가 루프를 빠져나오거나 연결을 끊었을 때 에이전트 노드가 멈추지 않고 계속 실행되던 중요한 비동기 제어 문제가 수정됐습니다.
발생했던 문제: 고아 태스크(Orphaned Run)와 토큰 누수
웹 서비스나 대화형 UI에서 사용자가 "답변 중단" 버튼을 누르거나 페이지를 벗어나면, 프론트엔드와 연결된 서버 측 스트림 소비 코드는 일반적으로 for await...of 루프에서 break하거나 리더를 닫습니다.
// 문제의 코드 패턴
for await (const chunk of await graph.stream(inputs)) {
if (userCancelled()) {
break; // v1.7.2 이하에서는 이 루프를 빠져나와도 백그라운드 노드가 계속 실행됨
}
}
v1.7.2 이하 버전에서는 명시적으로 stream.cancel()을 직접 호출하지 않는 한, 소비자가 루프를 탈출하더라도 LangGraph 내부의 그래프 실행 엔진(runner)에 취소 신호가 전파되지 않았습니다. 그 결과:
- 백그라운드 API 호출 지속: 이미 화면에 노출되지 않을 응답을 위해 모델 API와 외부 도구가 계속 호출되어 불필요한 토큰 비용이 발생했습니다.
- 상태 불일치 및 컨트롤러 에러: 스트림 소비가 끝난 상태에서 뒤늦게 도착한 토큰을 밀어 넣으려다
StreamMessagesHandler에서TypeError [ERR_INVALID_STATE]: Controller is already closed에러가 발생하며 서버 프로세스에 부하를 주었습니다.
v1.7.3에서의 변경점
v1.7.3에서는 graph.stream() 및 graph.streamEvents()의 비동기 제너레이터(AsyncGenerator)에 return() 핸들러 및 리더 취소 훅이 강화됐습니다:
- 소비자 탈출 자동 감지:
for await...of루프에서break,return,throw가 발생하면 제너레이터의 반환 흐름을 감지하여 실행 중인 그래프 실행 런(run)을 자동으로 즉시 중단합니다. - 하위 노드 AbortController 신호 전파: 실행 중이던 비동기 노드 및 모델 호출에 전달된
AbortSignal이 트리거되어 대기 중인 네트워크 요청이 즉각 취소됩니다. - 컨트롤러 안전 닫기: 스트림 리더가 이미 취소되었을 때 발생하는 불필요한 예외를 방지하도록
StreamMessagesHandler의 수명 주기가 정돈됐습니다.
1.7.2 vs 1.7.3 동작 비교 검증
| 시나리오 | 1.7.2 이하 동작 | 1.7.3 동작 |
|---|---|---|
for await 루프 내 break |
소비만 멈추고 그래프 노드는 백그라운드에서 끝까지 실행 | 그래프 실행 즉시 중단, 후속 노드 실행 취소 |
| 브라우저 연결 끊김 (SSE 닫힘) | 백그라운드에서 LLM 토큰 소모 지속 | 클라이언트 취소 신호 전파로 API 요청 Abort |
명시적 stream.cancel() 누락 시 |
리소스 누수 발생 | 루프 탈출만으로 안전하게 자동 회수 |
| 콘솔 에러 발생 빈도 | ERR_INVALID_STATE 간헐적 발생 |
스트림 정상 종료 처리로 예외 억제 |
실무 서비스에서 LangGraph.js 기반의 에이전트 스트리밍 API를 운영하고 있다면, stream.cancel()을 별도로 관리하기 어려운 복잡한 라우터 환경에서도 불필요한 LLM 비용을 막을 수 있는 필수 패치입니다.