본문으로 건너뛰기
목록으로 돌아가기
스터디
13 분

결제 버그 하나가 로그인까지 멈추게 할 때: CQRS와 장애 반경 줄이기 입문

장애를 많이 겪은 개발자에게 격리는 본능이 된다. CQRS는 쓰기 모델과 읽기 모델을 나누는 패턴이지만, 모델만 나눈다고 장애가 격리되지는 않는다. 같은 커넥션 풀을 쓰면 결제 쓰기 버그에 조회도 함께 멈춘다. 표준 라이브러리만 쓰는 토이 예제로 '모델 분리'와 '자원·배포 분리'의 차이, 그리고 CQRS를 쓰지 말아야 할 때를 정리한다.

박효열 (Hyoyoul Park)
#CQRS#아키텍처#장애 격리#Bulkhead#이벤트 소싱#Python

2026-11-04 확인. 출발점은 Threads 포스트다. 원문은 인용하지 않았고 링크만 출처로 남긴다. 같은 날 다시 연 1차 자료는 Martin Fowler의 CQRS(2011-07-14), CommandQuerySeparation, Event Sourcing, 그리고 Azure Architecture Center의 CQRS, Event Sourcing, Bulkhead다. Greg Young의 CQRS Documents와 Azure의 Transactional Outbox 가이드도 같은 날 HTTP 200이었다. PDF 본문과 Cosmos 절차는 이 글에서 인용하지 않는다. 아래 토이 예제는 개념 시연이며 실제 시스템 성능을 뜻하지 않는다.

먼저 결론

CQRS는 쓰기(명령) 모델과 읽기(조회) 모델을 나누는 패턴이다. 모델을 나누었다는 사실만으로 장애가 격리되지는 않는다.

결제 쓰기가 고장 나도 조회가 살아 있으려면, 읽기 측이 쓰기 측과 다른 저장소, 다른 커넥션 풀, 다른 프로세스나 배포를 가져야 한다. 자원을 이렇게 칸으로 나누는 일은 bulkhead 패턴의 영역이다. Azure CQRS 문서가 "CQRS isolates failures"라고 적는 자리는, 다른 서브시스템과 통합할 때, 특히 이벤트 소싱을 함께 쓰는 시스템을 말하는 한 항목이다. 패턴 이름 전체에 붙는 보장이 아니다.

대가도 그 자리에 같이 있다. 저장소를 나누면 조회는 잠시 옛 값을 볼 수 있다. 이벤트로 맞추면 메시지가 중복되거나 재시도된다. Fowler는 2011-07-14 bliki에서, 대부분의 시스템에 CQRS가 위험한 복잡도를 더한다고 경고한다.

단순 CRUD로 충분한 도메인에는 쓰지 않는다. 쓴다면 시스템 전체가 아니라 Bounded Context 하나에만 쓴다.

왜 경력자는 격리를 찾게 되나

Threads 첫 글은 공개 페이지에서 읽혔다. 요지를 두 문장으로 옮기면 이렇다. 장애가 옆 기능으로 번진 경험을 반복하면, 격리는 취향이 아니라 본능에 가까워진다. 그 글은 CQRS를 그 본능과 함께 소개한다. 원문 문장은 인용하지 않는다.

같은 스레드의 뒤 글이 그린 장면은, 요약으로만 남아 있는 그림에서, 결제 버그 하나가 로그인·검색·장바구니까지 같이 멈추는 예시다. 그 뒤 글은 2026-11-04 공개 페이지에서 읽히지 않았다. 이 문단의 장면은 그날 조사 노트의 요약에 의존한다. 특정 회사의 장애 보고서로 대조한 사건이 아니다.

연쇄가 나는 경로는 문서에 있다. Azure Bulkhead는 클라이언트의 커넥션 풀을 대표 예로 든다. 응답하지 않는 서비스에 붙잡은 커넥션이 풀을 바닥내고, 그 클라이언트는 다른 서비스도 부르지 못한다. 같은 문서는 소비자 쪽 칸막이로 프로세스, 스레드 풀, 세마포어를 든다. Azure CQRS는 같은 데이터 집합에 대한 병렬 연산이 락 경합을 만든다고 적는다. 공유 풀이 비거나 공유 락이 잡히면, 결제와 무관한 조회도 그 자원을 기다리는 쪽에 선다.

이 문단은 해석이다. 그 요약 속의 결제 버그는 CQRS라는 이름보다, 풀과 프로세스를 나누는 bulkhead에 더 직접 맞닿아 있다. 현실적인 그림은 둘을 같이 쓴다. CQRS가 읽기 측을 떼어 낼 경계를 만들고, bulkhead가 그 경계에 실제 자원 칸을 세운다.

CQRS 한 장 요약

명령-조회 분리(CQS)는 Bertrand Meyer가 메서드에 대해 말한 원칙이고, Fowler의 CommandQuerySeparation bliki가 그 용어를 소개한다. 쿼리는 결과를 돌려주고 관찰 가능한 상태를 바꾸지 않는다. 커맨드는 상태를 바꾸고 값을 돌려주지 않는다. CQRS는 그 어휘를 메서드가 아니라 모델로 끌어올린 것이다. Fowler는 이 패턴을 Greg Young에게서 처음 들었다고 적는다. 갱신에 쓰는 모델과 읽기에 쓰는 모델을 다르게 두는 것이 핵심이다.

Command → Write model → Events → Projector → Read model ← Query

Fowler가 적은 이득은 두 방향이다. 하나는 복잡한 도메인에서 명령과 조회를 한 개념 모델에 두면 둘 다 서툴러지는 경우다. 그는 그런 적합이 소수라고 못 박는다. 다른 하나는 읽기 부하와 쓰기 부하를 나눠 각각 확장하는 경우다. 조회 일부만 무겁다면, 모든 조회를 다른 모델로 옮기는 CQRS 대신 ReportingDatabase로 무거운 조회만 빼는 대안이 있다. 그의 설명에서 CQRS는 모든 조회에 별도의 모델을 쓴다.

Azure는 구현을 두 단계로 나눈다. 기초는 저장소는 하나이고 모델만 다른 것이다. 쓰기 모델은 검증과 도메인 규칙을 두고, 읽기 모델은 화면에 줄 DTO나 프로젝션을 둔다. 고급은 저장소도 나눈다. 쓰기 측이 이벤트를 발행하면 읽기 측이 그 이벤트로 자신을 갱신한다. 데이터베이스와 메시지 브로커를 한 분산 트랜잭션에 넣기 어려우므로, Azure는 Transactional Outbox로 상태 변경과 이벤트를 원자적으로 남기고, 읽기 측 소비자는 중복 전달을 견디도록 멱등으로 만들라고 한다.

이벤트 소싱은 다른 패턴이다. Fowler는 애플리케이션 상태의 변경을 모두 이벤트 열로 남기는 것으로 정의한다. Azure는 현재 상태만 저장하지 않고, 객체에 일어난 행동의 열을 append-only 저장소에 두는 것으로 정의한다. 둘은 자주 겹친다. Fowler의 CQRS 글은 이 패턴이 이벤트 기반 모델과 잘 맞고, 그 모델이 이벤트 소싱을 받아들이기 쉽게 한다고 말한다. Azure CQRS 글은 일부 구현이 이벤트 소싱을 끌어들이며, 그때 복잡도가 커진다고 말한다. 잘 맞는 것과 한 패턴인 것은 다르다. 이 글은 조사 노트의 구분을 유지한다. 이벤트 소싱은 CQRS에 필수 조건이 아니다.

Azure가 문제로 적는 것은 세 가지다. 복잡도, 특히 이벤트 소싱을 더할 때. 메시징을 쓸 때의 실패, 중복, 재시도. 그리고 최종 일관성이다. 저장소를 나누면 읽기는 stale, 즉 곧바로 최신이 아닌 값이 될 수 있다.

모델 분리 ≠ 장애 격리

같은 "나눔"이 세 단계로 다르다. 오른쪽 칸은 쓰기 경로가 커넥션을 반납하지 않을 때 조회가 어떻게 되는지를 이 글이 각 단계에 적용한 것이다. 1단계와 2단계에서 실패가 번지는 방식은 Azure Bulkhead가 적은 풀 고갈을 그 구조에 올려 둔 것이다. 3단계에서 조회가 남는 것은 풀과 배포가 다를 때 가능해지는 결과다.

단계모델저장소와 풀쓰기 경로가 커넥션을 새게 할 때 조회
1. 한 모델명령과 조회가 같은 모델같은 DB, 같은 풀그 풀에서 커넥션을 빌리는 조회는 쓰기와 같이 멈춘다
2. 모델만 분리명령 모델과 조회 모델이 다름같은 DB 또는 같은 풀. Azure가 말하는 CQRS의 기초고갈된 풀에서 빌리면 조회도 멈춘다. 모델이 둘이라는 사실은 커넥션을 늘리지 않는다
3. 모델과 자원모델도 다르고 저장소도 다름다른 저장소, 다른 풀, 다른 프로세스나 배포조회는 마지막 프로젝션을 계속 제공할 수 있다. 그 값은 잠깐 옛 값일 수 있다

2단계를 기초 수준이라고 부르는 것은 Azure 문서의 구분이다. "모델이 둘이면 풀도 둘이어야 한다"는 문장은 그 문서에 없다. 이 문장은 해석이다. CQRS가 격리에 기여하는 지점은, 읽기 측에 별도의 저장소와 프로세스와 풀을 줄 수 있는 경계를 만든다는 데 있다. 경계만 만들고 자원은 그대로 공유하면, 이름에서의 분리와 장애 반경에서의 분리는 다른 사건이 된다.

토이 예제로 확인

cqrs-blast-radius-toy.py는 Python 표준 라이브러리만 쓰고 난수를 뽑지 않는다. 결정적이다. 파일은 68줄이다. 시나리오는 파일 머리말에 적혀 있다. 주문 3건이 성공한 뒤 결제 버그가 난다. 그다음 place_order 5번은 예외를 던지고, 새는 DB 커넥션처럼 풀에 커넥션을 돌려주지 않는다. 풀 크기는 3이다. 이어서 조회를 10번 호출한다.

모드는 세 가지다.

  • coupled. 읽기와 쓰기가 한 모델, 한 풀을 쓴다.
  • cqrs_shared. 이름은 명령 모델과 조회 모델을 나누지만, 풀은 같다.
  • cqrs_split. 모델도 풀도 다르고, 읽기 모델은 이벤트로 채운다.

풀이 갈라지는 줄은 이렇다.

    write_pool = Pool(pool_size)
    read_pool = write_pool if mode in ("coupled", "cqrs_shared") else Pool(pool_size)

버그는 커넥션을 돌려주기 전에 예외를 던진다.

        write_pool.acquire()
        if bug:               # bug: raise before release -> leaked connection
            w_fail += 1
            raise PaymentBug(oid)

조회가 어느 딕셔너리를 보는지도 모드에 따라 다르다.

            src = read_model if mode == "cqrs_split" else store

cqrs_shared는 읽기용 딕셔너리를 따로 만들지 않는다. 조회는 coupled와 같이 store를 본다. 가운데 모드가 실제로 구현하는 차이는 두 번째 모델이 아니다. 풀을 그래도 공유한다는 점이다. 이 스크립트는 표의 2단계, 즉 "다른 모델, 같은 풀"을 그대로 실행한 프로그램이 아니다.

2026-11-04에 python3로 실행한 출력은 아래와 같다.

coupled      writes ok=3 failed=5 | reads ok=0/10 | last view=None
cqrs_shared  writes ok=3 failed=5 | reads ok=0/10 | last view=None
cqrs_split   writes ok=3 failed=5 | reads ok=10/10 | last view=['o0', 'o1', 'o2']

세 모드 모두 성공한 쓰기는 3이고 실패한 쓰기는 5다. 실패 5의 구성은 코드를 따라가면 나온다. 풀의 빈 자리는 3개이므로, 버그 쓰기 5번 중 앞의 3번은 PaymentBug를 던지며 커넥션을 흘리고, 뒤의 2번은 acquire 안에서 PoolExhausted로 실패한다. 두 종류 모두 failed에 센다.

coupled와 cqrs_shared의 조회는 10번 중 0번이고 last view는 None으로 남는다. 공유 풀에 빌려 줄 커넥션이 없어서 조회가 acquire에 실패한다. cqrs_split의 조회는 10번 중 10번이고, 마지막 뷰는 ['o0', 'o1', 'o2']다. 읽기 풀은 크기 3의 다른 풀이고, my_orders는 finally에서 커넥션을 돌려준다. project()는 버그 이전, 성공한 주문 3건 뒤에 한 번 돈다. 버그 분기는 이벤트를 넣기 전에 예외를 던지므로 읽기 모델에는 그 3건만 남는다.

이 문단은 해석이다. 조회를 살린 것은 "모델 분리"라는 이름이 아니다. cqrs_shared는 명령과 조회를 나눈 척하지만 결과는 coupled와 같다. 살린 것은 자원 분리다. 읽기 풀이 쓰기 풀이 아니고, 조회는 이미 만들어진 프로젝션을 읽는다.

토이가 받아 주지 않는 주장도 적는다. 버그 쓰기는 커밋되지 않는다. 이 출력의 뷰는 "성공한 쓰기를 프로젝션이 아직 따라잡지 못한 지연"이 아니다. 버그 이전의 마지막 성공 상태다. 저장소를 나눈 CQRS에서 조회가 옛 값을 보는 최종 일관성은 Azure가 그 구조에 대해 적은 성질이다. 이 스크립트는 그 지연을 측정하지 않는다. 락도, 스레드도, 네트워크도, 배포 단위도 없다.

CQRS, 이벤트 소싱, Bulkhead

CQRS이벤트 소싱Bulkhead
목적쓰기 모델과 읽기 모델을 나눈다상태 변경을 이벤트 열로 저장한다자원을 풀로 나눠 한 곳의 고장이 번지지 않게 한다
다루는 문제한 모델이 명령과 조회를 둘 다 서툴게 하는 경우, 그리고 읽기 부하와 쓰기 부하의 분리현재 상태만 저장하면 변경의 역사가 사라지는 경우. 이벤트 열로 과거를 다시 만들 수 있다공유 커넥션 풀이 마르듯, 한 의존성의 실패가 무관한 호출까지 멈추는 경우
필수인가이벤트 소싱 없이 쓸 수 있다. Bulkhead의 전제도 아니다CQRS에 필수 아님CQRS에 필수 아님. 풀을 나누는 것만으로 패턴이 성립한다
비용복잡도. 저장소를 나누면 stale, 메시징을 쓰면 중복과 재시도. Fowler는 대부분의 시스템에 위험한 복잡도로 본다Azure는 대부분의 시스템에 전통적인 데이터 관리로 충분하고, 이 패턴을 채택하면 이후 설계가 제약된다고 적는다자원을 덜 효율적으로 쓸 수 있고, 칸을 나누는 일이 복잡도를 더한다. 그 복잡도가 필요 없으면 쓰지 말라고 같은 문서가 적는다

"CQRS를 도입하면 장애가 격리된다"를 이 표에서 읽으면 열이 섞인다. 격리의 열은 Bulkhead다. CQRS의 열은 모델이다. 이벤트 소싱의 열은 저장 형식이다.

쓰지 말아야 할 때

Fowler는 CRUD라는 정신 모형에 맞는 시스템은 그 방식으로 만들라고 한다. CQRS는 관계된 모두에게 큰 사고의 도약이라, 이득이 그 도약을 감당할 때만 시도해야 한다. 결정은 시스템 전체가 아니라 Bounded Context마다 따로 한다. 그는 자신이 본 사례의 다수가 좋지 않았고, CQRS가 시스템을 심각한 어려움으로 미는 힘이 된 경우가 많았다고 적는다. 인용은 그의 문장 하나로 줄인다. "for most systems CQRS adds risky complexity."

Azure가 부적합할 수 있다고 적는 조건은 두 개다. 도메인이나 업무 규칙이 단순할 때. CRUD 수준의 화면과 데이터 접근으로 충분할 때.

대안은 패턴을 통째로 들이지 않는 쪽에 있다. 무거운 조회만 문제면 Fowler의 ReportingDatabase. 읽기 확장만 필요하면, Azure가 읽기 저장소의 한 형태로 적는 읽기 전용 복제본. 장애 반경만 문제면 Bulkhead 문서에 더 작은 세트가 이미 있다. 의존성마다 커넥션 풀을 나누고, 서비스를 별도의 프로세스, 컨테이너, 가상 머신으로 두며, 재시도, 서킷 브레이커, 스로틀링과 조합하는 것이다.

타임아웃을 그 목록에 넣는 것은 이 글의 해석이다. Bulkhead 문서는 재시도, 서킷 브레이커, 스로틀링을 이름으로 적는다. 타임아웃 패턴을 지정하지는 않는다. 풀이 마르는 것을 막으려 할 때 타임아웃을 그 셋 옆에 두는 일은 흔하지만, 그 배치는 이 글의 판단이지 문서에서 복사한 목록이 아니다.

도입한다면 체크리스트

앞의 네 항목은 위 문서에서 바로 꺼낸 것이다. 뒤의 두 항목은 그 문서가 적은 위험을 운영 상의 확인으로 바꾼 것이다. 뒤의 둘은 해석이다.

  1. Bounded Context 하나에서 시작한다. CQRS를 시스템 전체의 기본 아키텍처로 올리지 않는다. Fowler.
  2. 저장소를 나눈다면 Transactional Outbox로 상태 변경과 이벤트를 함께 남긴다. Azure CQRS.
  3. 프로젝터, 즉 읽기 모델을 갱신하는 소비자를 멱등으로 만든다. 같은 문서가 중복 전달을 전제로 그렇게 권한다.
  4. 읽기 측에 별도의 풀과 별도의 배포를 준다. 프로세스, 컨테이너, 또는 가상 머신이다. 모델만 나누고 풀을 공유하면 토이에서처럼 조회가 쓰기와 같이 죽는다. 풀과 배포의 분리는 Bulkhead다.
  5. 조회가 옛 값일 수 있음을 UI에 표시하고, 사람이 그 값으로 결정하기 전에 허용 범위를 보여 준다. Azure는 사용자가 stale 데이터로 행동하는 경우를 다루라고 적는다. 그 처리를 눈에 보이는 허용 범위로 만드는 것은 이 글의 해석이다.
  6. 프로젝션 지연을 모니터링한다. Azure는 읽기 저장소가 가장 최근 변경을 바로 보이지 않을 수 있다고 적는다. 그 지연을 운영 지표로 두는 것은 이 글의 해석이다.

출처

  • Threads 포스트. 이 글의 출발점. 원문은 인용하지 않았다. 결제·로그인·검색·장바구니로 이어지는 예시는 2026-11-04 공개 페이지에서 읽히지 않아 요약만 사용했다.
  • Martin Fowler, CQRS. 2011-07-14. Greg Young에게서 처음 들었다는 기록, Bounded Context, 두 가지 이득, ReportingDatabase, "for most systems CQRS adds risky complexity."
  • Martin Fowler, CommandQuerySeparation. Bertrand Meyer의 명령-조회 분리. 메서드 단위의 원칙.
  • Martin Fowler, Event Sourcing. 상태 변경을 이벤트 열로 남기는 패턴. CQRS와 별개.
  • Greg Young, CQRS Documents (PDF). 2026-11-04에 이 주소는 cqrs.wordpress.com의 같은 파일로 리다이렉트되며 200이었다. 이 글은 PDF 본문을 인용하지 않는다.
  • Azure, CQRS pattern. 단일 저장소 안의 모델 분리와 저장소 분리, Transactional Outbox와 멱등 소비자, 복잡도, 메시지의 중복과 재시도, stale, CRUD에는 잘 맞지 않음, 통합과 이벤트 소싱 항목 안의 "CQRS isolates failures."
  • Azure, Event Sourcing pattern. 행동을 append-only 열로 저장. 대부분의 시스템에는 전통적인 데이터 관리로 충분하다는 경고.
  • Azure, Bulkhead pattern. 커넥션 풀 고갈, 스레드 풀, 프로세스·컨테이너·가상 머신, 재시도·서킷 브레이커·스로틀링.
  • Azure, Transactional Outbox (Cosmos DB). CQRS 문서가 가리키는 원자적 기록 패턴의 가이드. 이 글은 Cosmos 절차를 인용하지 않는다.
  • 토이 스크립트. 2026-11-04, python3 실행. 출력은 본문에 인용한 세 줄과 같다.