test(persistence-jpa): 동시 writer 시험이 replay 순서를 받은 위치 순서로 본다 #39

Merged
donghyeon.kang merged 2 commits from claude/r9-live-event-order into main 2026-11-13 11:43:53 +00:00
Owner

무엇을, 왜

main 검사 #148(run 260, d32b4b53)의 :adapter:outbound:persistence-jpa:jpaPlatformContractTest에서 LiveEventLogContractTest 「two concurrent writers receive different positions and both commit」이 실패했다(434건 중 1건).

원인은 시험 쪽 경합이다.

  • 두 writer를 latch 하나로 동시에 푼다.
  • 위치는 containsExactlyInAnyOrder(1L, 2L)로 순서 없이 본다.
  • 그런데 replay는 containsExactly("from-first", "from-second")로 본다. 먼저 제출한 writer가 1번을 받는다고 가정하는 셈이다.
  • 부하 아래에서는 second가 1번을 받는다. 2026-09-29부터 있던 흔들림이다.

고른 방법과 버린 대안

  • 고른 방법: 각 Future가 돌려준 위치를 키로 값을 TreeMap에 모은다. 키가 정확히 1·2인지 보고, replay 순서가 위치로 정렬한 값과 같은지 본다. 시험은 「위치 순서 = replay 순서」를 지킨다. 스레드 시작 순서는 보지 않는다.
  • 같이 한 것: 고친 메서드의 영어 @DisplayName을 테스트 작성 규칙(.claude/rules/java-tests.md 2)대로 한국어로 바꾸고 GWT 주석을 붙였다.
  • 버린 대안:
    • latch 둘로 writer 순서를 강제한다. 동시에 쓰는 경우를 더는 보지 않게 된다.
    • replay를 순서 없이 본다. replay가 위치 순서를 따르는지를 놓친다.

같은 모양 찾기

grep으로 범위를 좁혀 읽었다.

  • 대상: 백엔드 시험 source set 전체에서 아래 둘이 함께 있는 파일이다.
    • 동시에 일을 푸는 코드: CountDownLatch·CyclicBarrier·Phaser·Executors·invokeAll·supplyAsync·runAsync
    • 순서 단언: containsExactly·get(0)·getFirst
  • 결과: 이 시험을 빼면 27개다.
    • 앞 단계를 latch로 기다려 순서를 강제한다.
    • 또는 개수·집합으로 본다.
    • 또는 한 스레드가 정한 순서를 본다.
  • 결론: 스레드 시작 순서를 결과 순서로 단언하는 곳은 이 시험 하나였다.

위험과 영향

  • 시험 코드만 바뀐다. production 동작은 그대로다.
  • 찾기는 위 이름 목록에 기댄다. 다른 방식으로 스레드를 만드는 시험은 보지 않았다.

검증

모두 desktop에서 --no-build-cache로 돌렸다.

실행 트리 결과
RED 탐침: main + second가 먼저 위치를 잡게 강제, --tests '*LiveEventLogContractTest' fb3f3284 rc=1. replay 단언 하나가 실패하고 실제 값은 [from-second, from-first]다. run 260과 같은 실패다
고친 시험 + 같은 강제 순서 d7cb6975 rc=0(11건 실패 0)
고친 시험 클래스 --rerun 5회 461ffa24 모두 rc=0
:adapter:outbound:persistence-jpa:jpaPlatformContractTest(필터 없음) 461ffa24 rc=0(434건 실패 0)
scripts/verify.sh pr --no-cache 461ffa24 rc=0(6905건 실패 0, skip 35, FROM-CACHE 0). 로그 desktop ~/claude-r9-live-event-order-logs/pr.log

리뷰어가 볼 곳

  • LiveEventLogContractTest.concurrentWritersAllocateDistinctPositions: 위치를 키로 모으는 곳과 두 단언.

관련

  • #37·#38과 별개다.
## 무엇을, 왜 main 검사 #148(run 260, d32b4b53)의 `:adapter:outbound:persistence-jpa:jpaPlatformContractTest`에서 `LiveEventLogContractTest` 「two concurrent writers receive different positions and both commit」이 실패했다(434건 중 1건). 원인은 시험 쪽 경합이다. - 두 writer를 latch 하나로 동시에 푼다. - 위치는 `containsExactlyInAnyOrder(1L, 2L)`로 순서 없이 본다. - 그런데 replay는 `containsExactly("from-first", "from-second")`로 본다. 먼저 제출한 writer가 1번을 받는다고 가정하는 셈이다. - 부하 아래에서는 second가 1번을 받는다. 2026-09-29부터 있던 흔들림이다. ## 고른 방법과 버린 대안 - 고른 방법: 각 Future가 돌려준 위치를 키로 값을 `TreeMap`에 모은다. 키가 정확히 1·2인지 보고, replay 순서가 위치로 정렬한 값과 같은지 본다. 시험은 「위치 순서 = replay 순서」를 지킨다. 스레드 시작 순서는 보지 않는다. - 같이 한 것: 고친 메서드의 영어 `@DisplayName`을 테스트 작성 규칙(`.claude/rules/java-tests.md` 2)대로 한국어로 바꾸고 GWT 주석을 붙였다. - 버린 대안: - latch 둘로 writer 순서를 강제한다. 동시에 쓰는 경우를 더는 보지 않게 된다. - replay를 순서 없이 본다. replay가 위치 순서를 따르는지를 놓친다. ## 같은 모양 찾기 grep으로 범위를 좁혀 읽었다. - 대상: 백엔드 시험 source set 전체에서 아래 둘이 함께 있는 파일이다. - 동시에 일을 푸는 코드: `CountDownLatch`·`CyclicBarrier`·`Phaser`·`Executors`·`invokeAll`·`supplyAsync`·`runAsync` - 순서 단언: `containsExactly`·`get(0)`·`getFirst` - 결과: 이 시험을 빼면 27개다. - 앞 단계를 latch로 기다려 순서를 강제한다. - 또는 개수·집합으로 본다. - 또는 한 스레드가 정한 순서를 본다. - 결론: 스레드 시작 순서를 결과 순서로 단언하는 곳은 이 시험 하나였다. ## 위험과 영향 - 시험 코드만 바뀐다. production 동작은 그대로다. - 찾기는 위 이름 목록에 기댄다. 다른 방식으로 스레드를 만드는 시험은 보지 않았다. ## 검증 모두 desktop에서 `--no-build-cache`로 돌렸다. | 실행 | 트리 | 결과 | |---|---|---| | RED 탐침: main + second가 먼저 위치를 잡게 강제, `--tests '*LiveEventLogContractTest'` | fb3f3284 | rc=1. replay 단언 하나가 실패하고 실제 값은 `[from-second, from-first]`다. run 260과 같은 실패다 | | 고친 시험 + 같은 강제 순서 | d7cb6975 | rc=0(11건 실패 0) | | 고친 시험 클래스 `--rerun` 5회 | 461ffa24 | 모두 rc=0 | | `:adapter:outbound:persistence-jpa:jpaPlatformContractTest`(필터 없음) | 461ffa24 | rc=0(434건 실패 0) | | `scripts/verify.sh pr --no-cache` | 461ffa24 | rc=0(6905건 실패 0, skip 35, FROM-CACHE 0). 로그 desktop `~/claude-r9-live-event-order-logs/pr.log` | ## 리뷰어가 볼 곳 - `LiveEventLogContractTest.concurrentWritersAllocateDistinctPositions`: 위치를 키로 모으는 곳과 두 단언. ## 관련 - #37·#38과 별개다.
donghyeon.kang added 1 commit 2026-11-13 09:42:22 +00:00
문제: LiveEventLogContractTest의 「두 writer 동시 쓰기」 시험은 두 writer를
latch 하나로 동시에 푼다. 위치는 순서 없이 1·2인지 보면서, replay는
from-first, from-second 순서로 단언한다. 「먼저 제출한 writer가 1번을
받는다」고 가정하는 셈이다. 어느 writer가 allocator에 먼저 닿는지는
스케줄러가 정한다. 그래서 부하 아래에서는 second가 1번을 받고 시험이
실패한다(main 검사 run 260, d32b4b53, 434건 중 1건). 2026-09-29부터 있던
흔들림이다.

고른 방법: 각 Future가 돌려준 위치를 키로 값을 TreeMap에 모은다. 키가
정확히 1·2인지 보고, replay 순서가 위치 순서로 정렬한 값과 같은지 본다.
이 시험이 지키는 성질은 「위치가 겹치지 않고 replay가 위치 순서를 따른다」
이다. 스레드 시작 순서는 지키는 성질이 아니다. 고친 메서드의 영어
@DisplayName은 테스트 작성 규칙대로 한국어로 바꿨다.

버린 대안:
- latch를 둘로 나눠 writer 순서를 강제한다. 동시에 쓰는 경우를 더는 보지
  않게 되어 이 시험의 목적이 사라진다.
- replay를 순서 없이(containsExactlyInAnyOrder) 본다. replay가 위치 순서를
  따르는지를 놓친다.

같은 모양 찾기: 백엔드 시험 source set 전체에서 동시에 일을 푸는 파일
(CountDownLatch·CyclicBarrier·Phaser·Executors·invokeAll·supplyAsync·
runAsync)과 순서 단언(containsExactly·get(0)·getFirst)이 함께 있는 파일을
grep으로 골라 읽었다. 이 시험을 빼면 27개다. 모두 앞 단계를 latch로
기다려 순서를 강제하거나, 개수·집합으로 보거나, 한 스레드가 정한 순서를
본다. 스레드 시작 순서를 결과 순서로 단언하는 곳은 이 시험 하나였다.

위험·한계: 시험 코드만 바뀐다. production 동작은 그대로다. 찾기는 위
이름 목록에 기댄다. 다른 방식으로 스레드를 만드는 시험은 보지 않았다.

검증(desktop, --no-build-cache):
- RED 탐침(main + second가 먼저 위치를 잡게 강제): jpaPlatformContractTest
  --tests '*LiveEventLogContractTest' rc=1. 실패는 replay 단언 하나이고
  실제 값은 [from-second, from-first]다. main 검사 run 260과 같은 실패다.
- 고친 시험 + 같은 강제 순서: rc=0(11건 실패 0).
- 고친 시험 클래스 --rerun 5회: 모두 rc=0.
- :adapter:outbound:persistence-jpa:jpaPlatformContractTest 필터 없이:
  rc=0(434건 실패 0).
- scripts/verify.sh pr --no-cache: rc=0(트리 461ffa24, 6905건 실패 0,
  skip 35, FROM-CACHE 0).

Refs: main 검사 #148(run 260, d32b4b53)
donghyeon.kang added 1 commit 2026-11-13 09:42:56 +00:00
Merge branch 'main' into claude/r9-live-event-order
pr / done (pull_request) Successful in 14m1s
aaa85c2a3b
donghyeon.kang merged commit c1338beaa8 into main 2026-11-13 11:43:53 +00:00
donghyeon.kang deleted branch claude/r9-live-event-order 2026-11-13 11:43:53 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#39