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)에 취소 신호가 전파되지 않았습니다. 그 결과:

  1. 백그라운드 API 호출 지속: 이미 화면에 노출되지 않을 응답을 위해 모델 API와 외부 도구가 계속 호출되어 불필요한 토큰 비용이 발생했습니다.
  2. 상태 불일치 및 컨트롤러 에러: 스트림 소비가 끝난 상태에서 뒤늦게 도착한 토큰을 밀어 넣으려다 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 비용을 막을 수 있는 필수 패치입니다.

출처: LangGraph.js v1.7.3 릴리스 노트 및 PR #3090.