A · CRUD와 안전한 상태 변경

재시도해도 안전한 MongoDB 일괄 수정 만들기

시간 초과 작업은 아직 미결제이고 기한도 지난 주문만 취소해야 합니다. 필터와 업데이트를 짝짓고, 동시 결제와 재시도를 고려해 결과를 검증하는 흐름을 살펴봅니다.

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

상황: 미결제 주문을 만료하는 작업

온라인 상점에서 고객에게 15분의 결제 시간을 준다고 해봅시다. 매분 실행되는 작업이 기한이 지난 주문을 pending에서 cancelled로 바꿉니다. 작업은 중간에 재시작될 수 있고, 두 작업이 겹칠 수 있으며, 결제 콜백이 마감 직전에 도착할 수도 있습니다. 처음 조회했던 문서 목록에 기대지 말고 허용할 상태 전이를 필터로 표현해야 합니다.

const cutoff = new Date();
const filter = {
  status: "pending",
  paymentDueAt: { $lt: cutoff }
};

const candidates = await orders.countDocuments(filter);
console.log(`취소 예정인 만료 주문: ${candidates}`);

const result = await orders.updateMany(filter, {
  $set: { status: "cancelled" },
  $currentDate: { cancelledAt: true }
});

console.log({ matched: result.matchedCount, changed: result.modifiedCount });

countDocuments()는 운영자가 대상을 미리 살피는 데 유용하지만 잠금은 아닙니다. 조회와 수정 사이에 컬렉션이 달라질 수 있습니다. updateMany()가 실행될 때 필터를 다시 적용하므로, 결제 콜백이 먼저 paid로 바꾼 주문은 더 이상 일치하지 않습니다. 작업 결과는 사전 건수가 아니라 수정 결과의 matchedCount와 modifiedCount로 판단하세요.

필터와 업데이트를 함께 설계하는 이유

필터에는 서로 다른 두 가지 보호 조건이 있습니다. status: "pending"은 상태 전이를 제한하고 paymentDueAt: { $lt: cutoff }는 시간 경계를 제한합니다. 첫 작업이 성공하면 해당 문서는 더 이상 미결제 상태가 아니므로 다음 실행이 건너뜁니다. 시간 초과나 프로세스 재시작으로 같은 작업을 다시 실행해도 안전한 성질을 멱등성이라고 합니다.

$set은 지정한 필드만 바꾸고 나머지 문서는 유지합니다. $currentDate는 MongoDB가 수정한 시각을 기록합니다. 작업 전체에서 같은 마감 기준을 사용해야 한다면 예제처럼 cutoff를 한 번 저장하세요. 문서마다 new Date()를 새로 만들면 경계 시각이 조금씩 달라집니다.

그럴듯하지만 잘못된 선택

{ status: "cancelled" }로 문서 전체를 교체하면 고객, 주문 항목, 감사 필드처럼 교체 문서에 복사하지 않은 데이터를 잃을 수 있습니다. 필드 한두 개를 바꿀 때는 $set, $currentDate 같은 업데이트 연산자를 사용하세요. 만료된 주문 전체를 처리하는 작업에서 updateOne()을 선택하면 일치하는 문서 중 최대 하나만 바뀝니다.

TTL 인덱스로 만료 주문을 지우는 것도 다른 작업입니다. TTL은 문서를 삭제할 뿐, 주문 상태를 취소로 바꾸거나 고객 지원을 위해 주문을 보존하거나 취소 이벤트를 만들지는 않습니다. 보존 기간이 끝나 문서를 자동 삭제하는 것이 목적일 때 TTL을 사용하세요.

원자성이 보장하는 범위

개별 문서 수정은 원자적입니다. 그러나 updateMany() 전체가 여러 일치 문서를 한 번에 모두 성공시키는 트랜잭션은 아닙니다. 주문과 별도 재고 문서의 변경이 반드시 함께 성공해야 한다면 그 요구사항을 명시하고 필요한 경우 트랜잭션을 사용하세요. 트랜잭션은 조정 비용이 있으므로 기본적으로 단일 문서 모델을 대신하는 수단으로 쓰지 않습니다.

matchedCount는 필터와 일치한 문서 수이고 modifiedCount는 실제 값이 바뀐 문서 수입니다. 이미 요청한 값인 문서가 일치하면 수정 건수가 0일 수도 있습니다. 두 값을 모두 기록하고 작업 식별자를 남기면 “처리할 주문이 없었음”과 “작업이 실행되지 않음”을 구분하기 쉽습니다.

이해 확인

질문: 결제 콜백과 만료 작업이 거의 동시에 실행될 수 있습니다. 왜 마감 시각만 필터에 넣지 않고 status: "pending"도 포함해야 할까요?

답: MongoDB가 수정을 적용할 때 주문이 아직 미결제인지 확인해야 합니다. 마감 시각만 사용하면 그 사이 결제된 주문도 일치할 수 있습니다. 두 작업의 상태 전이 규칙을 분명히 해야 하지만, 상태 조건을 둔 수정은 오래된 만료 작업이 새 상태를 덮어쓰는 일을 막습니다.

더 읽을 자료