B · Node.js 애플리케이션 코드

MongoDB 커서와 연결 풀을 의도에 맞게 사용하기

개별 DB 호출이 맞더라도 결과를 무제한으로 읽거나 요청마다 클라이언트를 만들면 API가 느려질 수 있습니다. 고객 주문 내역 페이지를 필터부터 커서 정리까지 따라가 봅니다.

독립 학습 글 · 2026년 11월 17일 공식 문서 기준 확인

상황: 주문 내역 API

계정 페이지에서 고객의 최근 주문 25개를 보여준다고 해봅시다. API는 예측 가능한 한 페이지를 반환하고 애플리케이션 메모리를 제한하며 여러 사용자가 동시에 요청해도 동작해야 합니다.

const cursor = orders.find(
  { customerId, status: "paid" },
  {
    projection: { _id: 1, placedAt: 1, total: 1 },
    sort: { placedAt: -1, _id: -1 },
    limit: 25
  }
);

try {
  for await (const order of cursor) {
    await writeOrderToResponse(order);
  }
} finally {
  await cursor.close();
}

정렬에 _id를 동률 구분자로 추가했습니다. 주문 두 개의 placedAt이 같으면 두 문서의 상대 순서가 요청마다 바뀔 수 있습니다. 다음 페이지를 마지막으로 본 문서 다음부터 가져오려면 안정적인 정렬이 중요합니다.

커서는 배열이 아니라 읽기 계획입니다

Node.js 드라이버에서 find()는 동기적으로 커서를 반환합니다. 일치하는 모든 문서가 담긴 Promise를 반환하지 않습니다. 따라서 await collection.find(...)는 커서를 소비하지 않습니다. 문서는 for await...of로 반복하거나, 제한된 커서에 toArray()를 호출할 때 전달됩니다.

결과가 작고 크기가 제한되어 있을 때 toArray()는 편리합니다. 하지만 쿼리에 제한이 없거나 문서가 크면 메모리 문제가 생길 수 있습니다. 내보내기나 배치 작업은 문서를 하나씩 처리하고 버리는 반복 방식이 적합합니다. 작업 목적에 맞는 건수 제한이나 스트리밍 방식을 정하세요.

요청마다 클라이언트를 만들지 않기

애플리케이션 시작 시 MongoClient 하나를 만들고 연결한 뒤 여러 요청이 클라이언트의 연결 풀을 사용하게 하세요. 클라이언트는 배포의 서버별로 풀을 관리합니다. 각 작업은 연결을 빌려 사용하고 반환합니다. 라우트가 요청마다 새 클라이언트를 만들면 연결을 재사용하지 못하고 동시 요청이 늘 때 연결 생성이 반복됩니다.

async function startDatabase(uri) {
  const client = new MongoClient(uri);
  await client.connect();
  const orders = client.db("shop").collection("orders");

  return {
    orders,
    async close() {
      await client.close();
    }
  };
}

풀을 사용한다는 이유로 크기를 임의로 키우면 안 됩니다. 기본값으로 시작하고 대기 시간과 동시 요청 수를 측정한 뒤 실제 배포 환경과 부하에 맞게 조정하세요. 동시 실행이 많은 비싼 읽기는 연결 풀만으로 해결되지 않으므로 앱 차원의 동시성 제한도 살펴야 합니다.

그럴듯하지만 잘못된 선택

제한 없이 toArray()를 호출하면 API가 전송할 수 있는 양보다 훨씬 많은 문서를 읽을 수 있습니다. 요청마다 새 클라이언트를 만들면 풀을 재사용하지 못합니다. HTTP 응답이 끝난 뒤 커서를 반환하는 것도 수명 관리가 불명확합니다. 요청 안에서 커서를 소비하거나 스트리밍 응답의 수명을 명시적으로 관리하세요.

후속 작업이 쓰기 완료에 의존하면 해당 쓰기를 await 하세요. 여러 쓰기가 트랜잭션을 이룬다면 세션을 시작해 각 작업에 같은 세션을 전달해야 합니다. 세션을 만들었다고 모든 컬렉션 호출에 자동으로 적용되는 것은 아닙니다.

이해 확인

질문: await orders.find({ customerId })가 왜 주문 배열을 반환하지 않나요?

답: find()는 커서를 만듭니다. 드라이버는 커서가 소비될 때 결과 배치들을 가져옵니다. 작고 제한된 결과에는 toArray()를, 더 큰 결과에는 커서 반복을 사용하세요.

더 읽을 자료