test: #34가 남긴 SpotBugs 지적과 벽시계 상한 셋을 고친다 #43

Merged
donghyeon.kang merged 1 commits from claude/r9-main-red-fix into main 2026-11-13 17:13:54 +00:00
Owner

무엇을, 왜

백엔드 main이 빨갛다(main push run 269, c7a18ec7). 두 원인 모두 #34(벽시계 시험)가 남긴 것이고, 이 PR이 고친다.

  • graphql spotbugsSystemTest:
    • 원인: #34가 Error Prone의 CheckReturnValue를 피하려고 var unused = release.await(...)를 썼다. SpotBugs는 이것을 DLS_DEAD_LOCAL_STORE로 잡는다(RuntimeLimitsTestSupport.java:156).
    • 이 태스크는 main 단계에만 있어 PR run에서 보이지 않았다.
    • 고침: latch의 반환값을 쓰고, 풀려나지 않고 시한까지 간 호출 수를 센다(SLOW_CAPPED). SpotBugs 제외 목록에는 더하지 않았다.
  • httpclient 벽시계 상한 셋:
    • #34의 sweep이 놓친 시험이다. 셋 다 시한에 0.5초 여유를 둔 상한이라, 부하 아래에서 원인과 상관없이 실패한다.
    • 실제 실패: JettyAttemptDeadlineTest가 desktop main prCheck에서 부하 11~15일 때 1.68초 > 1.5초로 실패했다.
    • 같은 꼴: AttemptDeadlineEnforcementTest·StreamingSetupDeadlineTest.

고른 방법과 버린 대안

#34와 같은 방식이다.

  • 재는 구간을 호출 하나로 좁힌다(client·server 준비를 뺀다).
  • 상한은 시한 + 3초다. 그 상한이 서버의 흘림·지연보다 충분히 작다는 것을 함께 단언한다. 작지 않으면 상한이 「시한에 끊었다」를 증명하지 못한다.
    • 흘림은 10초로 늘렸다.
    • 늦은 헤더의 지연은 5초다. mock 서버는 클라이언트가 끊은 뒤에도 지연을 다 잔 다음 종료하고, 종료 대기가 5초라 그보다 길게 둘 수 없다.
  • 버린 대안: SpotBugs 지적을 config/spotbugs/exclude-test.xml로 덮는 안. 시험 코드라도 반환값을 버리는 latch 대기는 be-testing 함정 4다.

위험과 영향

시험 코드만 바뀐다. 운영 동작과 공개 표면은 그대로다. httpclient test는 늦은 헤더 시험 두 경우에서 서버 종료 때문에 몇 초 더 걸린다.

검증

  • 노트북 감싸개: :adapter:inbound:graphql:spotbugsSystemTest, :adapter:inbound:graphql:systemTest, :adapter:outbound:httpclient:test가 rc=0이다(73초, 최대 부하 6.47, 로그 노트북 ~/laptop-gate-logs/red-fix-20261113-211151.log).
    • RED는 main에서 같은 SpotBugs 태스크가 rc=1이었던 것이다(w2-be가 노트북 감싸개로 재현, ~/laptop-gate-logs/w2-graphql-spotbugs-20261113-211145.log).
    • 벽시계 실패는 부하에 따라 나서 RED를 결정적으로 재현하지 않았다.
  • desktop main 단계 태스크(정본 12.1의 7번): :adapter:inbound:graphql:spotbugsSystemTest(run 269에서 실패한 태스크), :adapter:inbound:graphql:testQualityCheck, :adapter:outbound:httpclient:testQualityCheck(바꾼 두 leaf의 시험 source set SpotBugs 전체). --no-build-cache로 rc=0이다. 트리 5a9e21d2, 로그 desktop ~/r9-be-logs/red-fix-main.log
  • desktop scripts/verify.sh pr --no-cache: head a03cca73(트리 5a9e21d2) 7034건 실패 0, 건너뜀 35, rc=0, FROM-CACHE 0. 기준 main c1338bea.

같은 원인 훑기(정본 12.1의 6번)

  • 원인 A — 시험이 blocking 호출(latch·future)의 반환값을 쓰지 않는 지역 변수로 받는다.
    • 기준: src/** 전체에서 git grep -E 'var unused = [a-zA-Z_.]*(await|join|get)\('를 돌렸고, 이 PR 뒤 0건이다.
    • 남은 var unused 넷(persistence-jpa 셋, notification 하나)은 catchThrowable·reap()의 결과다. exclude-test.xml의 unused 이름 규칙이 받고, main 단계 testQualityCheck가 이미 통과한다.
    • 범위 밖: 그 규칙이 try 블록 안 dead store에서 왜 이름을 못 읽었는지는 조사하지 않았다.
  • 원인 B — 고정 시간 가정. 시한에 1초 미만 여유를 둔 벽시계 상한.
    • 기준: src/** 전체에서 TOLERANCE = Duration.ofMillis, isLessThan(X.plus(Duration.ofMillis(...))), isLessThan(Duration.ofMillis(NNN))를 찾았다. 이 PR 뒤 0건이다.
    • main 단계 lane은 #34가 이미 훑었다.
    • 범위 밖: 다른 꼴(Duration.ofSeconds로 좁게 둔 상한, sleep에 기댄 순서)은 이 grep이 못 본다.

발견 ID 표

ID 판정 커밋
RR9-03-36 고침(#34가 남긴 SpotBugs 지적과 놓친 벽시계 시험 셋) a03cca73

관련

  • #34(벽시계 시험). 백엔드 main을 초록으로 만드는 PR이다(규칙 P-2).
## 무엇을, 왜 백엔드 main이 빨갛다(main push run 269, `c7a18ec7`). 두 원인 모두 #34(벽시계 시험)가 남긴 것이고, 이 PR이 고친다. - **graphql `spotbugsSystemTest`**: - 원인: #34가 Error Prone의 `CheckReturnValue`를 피하려고 `var unused = release.await(...)`를 썼다. SpotBugs는 이것을 `DLS_DEAD_LOCAL_STORE`로 잡는다(`RuntimeLimitsTestSupport.java:156`). - 이 태스크는 main 단계에만 있어 PR run에서 보이지 않았다. - 고침: latch의 반환값을 쓰고, 풀려나지 않고 시한까지 간 호출 수를 센다(`SLOW_CAPPED`). SpotBugs 제외 목록에는 더하지 않았다. - **httpclient 벽시계 상한 셋**: - #34의 sweep이 놓친 시험이다. 셋 다 시한에 0.5초 여유를 둔 상한이라, 부하 아래에서 원인과 상관없이 실패한다. - 실제 실패: `JettyAttemptDeadlineTest`가 desktop main prCheck에서 부하 11~15일 때 1.68초 > 1.5초로 실패했다. - 같은 꼴: `AttemptDeadlineEnforcementTest`·`StreamingSetupDeadlineTest`. ## 고른 방법과 버린 대안 #34와 같은 방식이다. - 재는 구간을 호출 하나로 좁힌다(client·server 준비를 뺀다). - 상한은 시한 + 3초다. 그 상한이 서버의 흘림·지연보다 충분히 작다는 것을 함께 단언한다. 작지 않으면 상한이 「시한에 끊었다」를 증명하지 못한다. - 흘림은 10초로 늘렸다. - 늦은 헤더의 지연은 5초다. mock 서버는 클라이언트가 끊은 뒤에도 지연을 다 잔 다음 종료하고, 종료 대기가 5초라 그보다 길게 둘 수 없다. - 버린 대안: SpotBugs 지적을 `config/spotbugs/exclude-test.xml`로 덮는 안. 시험 코드라도 반환값을 버리는 latch 대기는 be-testing 함정 4다. ## 위험과 영향 시험 코드만 바뀐다. 운영 동작과 공개 표면은 그대로다. httpclient `test`는 늦은 헤더 시험 두 경우에서 서버 종료 때문에 몇 초 더 걸린다. ## 검증 - 노트북 감싸개: `:adapter:inbound:graphql:spotbugsSystemTest`, `:adapter:inbound:graphql:systemTest`, `:adapter:outbound:httpclient:test`가 rc=0이다(73초, 최대 부하 6.47, 로그 노트북 `~/laptop-gate-logs/red-fix-20261113-211151.log`). - RED는 main에서 같은 SpotBugs 태스크가 rc=1이었던 것이다(w2-be가 노트북 감싸개로 재현, `~/laptop-gate-logs/w2-graphql-spotbugs-20261113-211145.log`). - 벽시계 실패는 부하에 따라 나서 RED를 결정적으로 재현하지 않았다. - desktop main 단계 태스크(정본 12.1의 7번): `:adapter:inbound:graphql:spotbugsSystemTest`(run 269에서 실패한 태스크), `:adapter:inbound:graphql:testQualityCheck`, `:adapter:outbound:httpclient:testQualityCheck`(바꾼 두 leaf의 시험 source set SpotBugs 전체). `--no-build-cache`로 rc=0이다. 트리 `5a9e21d2`, 로그 desktop `~/r9-be-logs/red-fix-main.log` - desktop `scripts/verify.sh pr --no-cache`: head `a03cca73`(트리 `5a9e21d2`) 7034건 실패 0, 건너뜀 35, rc=0, `FROM-CACHE` 0. 기준 main `c1338bea`. ## 같은 원인 훑기(정본 12.1의 6번) - **원인 A — 시험이 blocking 호출(latch·future)의 반환값을 쓰지 않는 지역 변수로 받는다.** - 기준: `src/**` 전체에서 `git grep -E 'var unused = [a-zA-Z_.]*(await|join|get)\('`를 돌렸고, 이 PR 뒤 0건이다. - 남은 `var unused` 넷(persistence-jpa 셋, notification 하나)은 `catchThrowable`·`reap()`의 결과다. `exclude-test.xml`의 `unused` 이름 규칙이 받고, main 단계 `testQualityCheck`가 이미 통과한다. - 범위 밖: 그 규칙이 try 블록 안 dead store에서 왜 이름을 못 읽었는지는 조사하지 않았다. - **원인 B — 고정 시간 가정. 시한에 1초 미만 여유를 둔 벽시계 상한.** - 기준: `src/**` 전체에서 `TOLERANCE = Duration.ofMillis`, `isLessThan(X.plus(Duration.ofMillis(...)))`, `isLessThan(Duration.ofMillis(NNN))`를 찾았다. 이 PR 뒤 0건이다. - main 단계 lane은 #34가 이미 훑었다. - 범위 밖: 다른 꼴(`Duration.ofSeconds`로 좁게 둔 상한, sleep에 기댄 순서)은 이 grep이 못 본다. ## 발견 ID 표 | ID | 판정 | 커밋 | | --- | --- | --- | | RR9-03-36 | 고침(#34가 남긴 SpotBugs 지적과 놓친 벽시계 시험 셋) | a03cca73 | ## 관련 - #34(벽시계 시험). 백엔드 main을 초록으로 만드는 PR이다(규칙 P-2).
donghyeon.kang added 1 commit 2026-11-13 13:34:37 +00:00
main 단계의 :adapter:inbound:graphql:spotbugsSystemTest가 #34의
`var unused = release.await(...)`를 DLS_DEAD_LOCAL_STORE로 잡아 main이
빨갛다. 이 태스크는 main 단계에만 있어 PR run에서 보이지 않았다.
latch의 반환값을 쓰고, 풀려나지 않고 시한까지 간 호출 수를 센다.

#34가 벽시계 시험을 고칠 때 httpclient 셋이 빠졌다. 셋 다 시한에 0.5초
여유를 둔 상한이라 부하 아래에서 원인과 상관없이 실패한다(Jetty 시험이
부하 11~15에서 1.68초 > 1.5초). #34와 같은 방식으로 고친다.
- 재는 구간을 호출 하나로 좁힌다(준비 시간을 뺀다).
- 상한은 시한 + 3초이고, 그 상한이 서버의 흘림·지연보다 작다는 것을
  함께 단언한다(작지 않으면 상한이 아무것도 증명하지 못한다).
- 늦은 헤더의 지연은 mock 서버의 종료 대기(5초)보다 짧게 둔다.

Refs: RR9-03-36
donghyeon.kang merged commit a1391853ac into main 2026-11-13 17:13:54 +00:00
donghyeon.kang deleted branch claude/r9-main-red-fix 2026-11-13 17:13:54 +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#43