32 KiB
32 KiB
번역 및 관리자 오디오 테스트 수정 계획
- 작성일: 2026-11-18
- 기준: prd.md
- 상태: P4 구현·경계/실제 worker/부족 예산/lint 검증·리뷰 승인·정리 완료. 전체 테스트 재실행은 미수행.
- 활성 Goal: 없음
P1-T1: 실패 원인 재현과 최소 테스트 수정
- 시작 조건: 사용자 지정 테스트와 운영 생성자/호출 경로를 읽는다.
- 완료 증거: 재현 오류, 테스트 전용 diff, 네 클래스 통과.
- 범위 밖: 운영 로직 변경 및 기존 assertion 약화.
- 대상 파일:
src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderSpringConfigurationTest.ktsrc/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/OriginalWorkReadRetryTest.ktsrc/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentControllerTest.ktsrc/test/kotlin/kr/co/vividnext/sodalive/v2/api/admin/aicharacter/content/AiCharacterAdminAudioContentOwnershipTest.kt
- TDD 예외: 신규 운영 동작이 아닌 기존 테스트 fixture/config 수정이다. 기존 실패 테스트를 재현 증거로 재사용한다.
- 기존 테스트 의도와 운영 의존성 확인.
- 실패 오류를 실행으로 확정.
- 최소 테스트 설정/fixture 수정.
- 같은 테스트 통과 확인.
./gradlew test --tests '*LanguageProviderSpringConfigurationTest' --tests '*OriginalWorkReadRetryTest' --tests '*AiCharacterAdminAudioContentControllerTest' --tests '*AiCharacterAdminAudioContentOwnershipTest' --console=plain
P1-GATE: 회귀와 변경 범위 확인
- 시작 조건: P1-T1 통과.
- 완료 증거: 직접 관련 회귀, 변경 파일 lint/컴파일, 리뷰, 임시 자원 정리.
- 번역 provider/read retry 및 관리자 오디오 직접 관련 회귀 통과.
- 변경 범위와 기존 assertion 보존 리뷰.
- 임시 자원 정리 및 결과 기록.
- 전체 테스트는 사용자 실행:
./gradlew test. focused 성공을 전체 성공으로 보고하지 않는다.
검증 기록
- 최초 focused 실행: LanguageProviderSpringConfigurationTest startupFailure 6건, OriginalWorkReadRetryTest
single()IllegalArgumentException 1건 확인. 200초 명령 제한으로 종료되어 관리자 테스트 및 XML 생성은 미완료. - 수정 전 완전 재현: 같은 네 클래스, 3분 27초, exit 1. 총 77개 중 71개 실패, skip 0. LanguageProvider 7개 중 6개는
PlatformTransactionManager빈 누락, OriginalWork 6개 중 1개는List has more than one element, 관리자 Controller 30개와 Ownership 34개는CreatorAdminContentService.applicationEventPublisher필드가 없어 준비 단계 실패. - 최소 수정: provider context에 기존 단위 테스트와 같은 transaction manager mock을 등록한다. 원작 테스트는 기존 ja FAILED 작업의 모든 상태 보존을 유지하면서 새 ko→en PENDING 작업의 정확한 개수·식별자·원문·초기 상태도 검증한다. 관리자 테스트는 실제 이벤트 소유 서비스와 현재 번역 무효화 경계를 검증한다.
- 관리자 두 테스트: 삭제된 CreatorAdminContentService publisher reflection만 제거하고, 실제 ContentTranslationSourceInvalidationService를 SpyBean으로 관찰해 거부 요청의 무호출을 검증한다. 정상 서비스 동작을 stub하지 않는다.
- 정적 검사: 변경 diff 공백 검사 통과. Kotlin LSP는 미설치이며 기존 설치 거부 설정 때문에 실행 불가. Gradle compileTestKotlin으로 타입/컴파일 검증을 수행한다.
- 수정 후 focused: 위 네 클래스 명령 exit 0, 6분 25초. 77/77 통과(LanguageProvider 7, OriginalWork 6, Controller 30, Ownership 34), failures/errors/skipped 모두 0.
compileTestKotlin실제 실행 성공, 운영 컴파일 UP-TO-DATE. 부모가 네 XML 헤더를 직접 확인했다. 보고서:build/reports/tests/test/index.html, XML:build/test-results/test/. - 확장 회귀: 아래 명령은
:test진입 후 600초 제한 초과. 최종 종료 코드·건수·새 XML이 없어 통과/실패를 판정하지 않는다. 컴파일은 UP-TO-DATE이며 새 assertion 실패는 수집되지 않았다. 전체 테스트는 미실행.
./gradlew test --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --tests '*LanguageProviderPropertiesTest' --tests '*TranslationCoordinatorTest' --tests '*LanguageDetectionCacheServiceTest' --tests 'kr.co.vividnext.sodalive.v2.api.admin.aicharacter.content.*' --console=plain
- 소유 검증 자원: 재현·검증 자식의 전용 임시 디렉터리 삭제 영수증 확인. 작업 시작 전부터 있던 사용자 worker/daemon은 변경하지 않았다. 부모 초기 임시 루트는 정리 확인 시 이미 존재하지 않았다.
- 최종 독립 리뷰: APPROVE, 차단 사유 없음. 네 테스트의 전체 변경 hunk를 운영 계약과 대조하여 assertion 보존과 실제 invalidation spy 동작을 확인했다. 기존 staged 변경은 보존했고, 운영 코드 변경 및 테스트 삭제/skip은 없다.
- 임시 작업 노트 삭제 완료. 추가 운영·테스트 코드 변경 없이 종료한다. P1-T1은 완료이고 확장 회귀 통과 체크는 미확인 상태로 남긴다. 전체 검증은 사용자가
./gradlew test로 수행한다.
재개 검증 (2026-11-18)
- 사용자가 미완료 지점부터 재개를 요청했다. 기존 77개 통과·리뷰 결과를 유지하고 전체 테스트로 남은 확장 회귀와 suite 결과를 함께 확인한다. 이번 실행은 재개 요청에 따른 명시적 검증이며 평상시 자동 전체 실행 규칙을 변경하지 않는다.
- 추가 코드 변경 없이
./gradlew --no-daemon test --console=plain을 한 번 실행한다. 이전의 600초 실행 제한 대신 긴 실행 시간을 허용한다. 실패하면 오류와 실제 종료 상태를 기록하고 운영 로직은 변경하지 않는다. - 전체 테스트 XML 집계 확인. 최종 원본 종료 코드 소실은 아래 검증 한계로 기록.
- 실행 소유 임시 자원 정리 및 결과 보고.
지연 원인 확인 및 사용자 승인 조치
- 전체 실행 약 47분 시점에
ps,jstat -gcutil, 현재 worker의jstack을 확인했다. 작업 전부터 있던 worker PID 97636은 약 2시간 48분 실행, CPU 1046.6%, Old 99.98%, Full GC 2207회·8588.794초, 총 GC 8652.617초였다. 기존 프로세스가 GC를 반복하며 자원을 점유했다. - 현재 전체 검증 worker PID 21732는 해당 시점 CPU 141.9%, Old 97.77%, 총 GC 71.327초였다. thread dump는 Spring context 초기화의 클래스 파일 탐색을 실행 중이었다. 전체 지연의 모든 원인을 확정한 것은 아니며 두 프로세스의 자원 경합은 관찰됐다.
- 사용자가 기존 worker 종료를 명시적으로 승인했다. PID 97636에 TERM을 보냈으나 잔존하여 KILL로 종료했다. 이후
ps에서 PID 97636 부재와 현재 검증 PID 21732 생존을 확인했다. IDE와 현재 검증 프로세스는 유지했다. - 전체 실행은 3,600,000ms 제한으로 중단됐다. Gradle 자체 종료 코드와 신규 XML은 없으므로 suite 결과는 미확정이다. 실행 소유 PID 21675/21732는 정리됐고 전용 임시 루트
verify-suite.USElvm도 삭제 확인했다. 제한 시간만 늘리는 반복 대신 context 캐시와 마지막 실행 위치를 조사한다.
P2: 승인된 테스트 자원 수명 개선
- 시작 조건: 사용자
진행한다승인. 기존 수정과 사용자 staged 변경은 보존한다. - 관측: 별도 IDE worker 31728도 Old 99.97%, 약 42초간 Full GC 11회·GC 시간 약 43초 증가. GC 과부하는 재현됐으나 retained object별 기여는 아직 미확인이다.
- 수정 경로:
build.gradle.kts,src/test/resources/application.yml, 조사로 확정한 test datasource override,src/test/kotlin/kr/co/vividnext/sodalive/support/H2DatabaseLifecycleTest.kt,docs/agent-guides/테스트스타일.md,docs/agent-guides/실행명령어.md. - 범위 밖: 운영 코드 변경, 무관한 테스트 재작성, 기존 staged 파일 수정, commit/push.
P2-T1: H2 DB 수명 검증과 정리
- 실제 test 설정을 읽는 lifecycle 테스트로 pool 종료 후 DB 잔존 실패 재현.
- H2 마지막 연결 종료 정책을 적용하고, 별도 override의 의존성을 확인해 필요한 것만 정리.
- 같은 lifecycle 테스트 및 직접 관련 연결/동시성 회귀 통과.
P2-T2: context 상한과 진행 진단
- 테스트 클래스 진행과 제한된 크기의 GC 로그를 확보.
- test worker의 Spring context 캐시 상한 4개를 초기 실험값으로 적용하고 실제 캐시/GC와 실행 결과 확인.
- 필요 시에만 worker 교체 주기를 별도 비교. 근거 없이 기본 적용하지 않는다.
P2-GATE: 전체 실행과 회귀 방지
- 전체 테스트 실행 결과와 GC 로그 비교. 진행 종료와 통과 여부를 각각 기록.
- 신규 테스트 자원 관리 규칙과 IDE Gradle runner 사용법 문서화.
- 변경 리뷰 및 실행 소유 자원 정리.
- 기존 IDE worker 31728이 실행 중이므로 새로운 테스트 실행 전 사용자에게 종료 승인을 받고 동일 build 출력 경합을 제거한다.
- 사용자가 실행 중인 worker 정리를 승인했다. PID 31728은 종료 전 57분 실행, CPU 1102.3%, Old 99.98%, Full GC 697회·1741.342초였다. TERM 후에도 잔존하여 KILL로 종료했고
jps -l에서 테스트 worker 부재를 확인했다. IDE와 Gradle daemon은 유지했다. - 먼저 진단만 추가:
build.gradle.kts에서 클래스 시작 로그, PID별 GC 로그(build/test-gc/test/gc-PID.log, 파일당 10MB·회전 3개), 명시적 단일 test worker를 설정했다. H2/cache 정책은 아직 변경하지 않았다../gradlew --no-daemon help --console=plainexit 0으로 Gradle Kotlin DSL 확인(20초). - H2 lifecycle RED:
./gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --console=plain, exit 1, 29초. 풀 종료 후IFEXISTS=TRUE재접속이 성공하여Expected java.sql.SQLException to be thrown, but nothing was thrown.실패. 연결 간 marker 데이터 공유와 pool 종료 assertion은 통과했다. 기존 YAML의 DB 잔존을 독립적으로 재현했다. - 1차 수정: 기본 YAML의
DB_CLOSE_DELAY=-1만0으로 변경한다. DB 고유 이름·나머지 옵션·운영 설정은 유지한다. 개별 override 29곳은 별도 단계로 검증한다. - H2 기본 설정 GREEN:
./gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --tests '*AiCharacterAdminAudioContentControllerTest' --tests '*AiCharacterAdminAudioContentOwnershipTest' --console=plain, exit 0, 약 1분, 65개 통과. context cache는 이 실행까지 기본 32를 유지했다. pool 종료 후 실제 DB 부재와 기존 DB/HTTP 동작을 확인했다. - 다음 단계: dedicated Hikari pool 소유이며 종료 후 재사용 근거가 없는 개별 테스트 override 29곳의 지연값만 0으로 바꾼다. 별도로 context cache 상한 4를 test worker systemProperty로 설정하고 context 재생성/동시성 회귀 및 전체 실행으로 확인한다.
forkEvery는 아직 도입하지 않는다. - 개별 override 29곳은 옵션 값만 변경했고 부모가 전체 diff를 확인했다. 연결 재오픈으로 DB 보존을 요구하는 사용처는 발견되지 않았다.
git diff --check통과. ./gradlew --no-daemon ktlintKotlinScriptCheck ktlintTestSourceSetCheck --console=plainexit 0, 54초. 최초 Kotlin DSL closure 줄바꿈 오류 2건은 수정 후 통과했다../gradlew --no-daemon test --tests '*H2DatabaseLifecycleTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --tests '*ServiceNoticeQueryRepositoryTest' --tests '*ServiceNoticeConcurrencyIntegrationTest' --console=plainexit 0, 2분 16초. XML 집계 20/20 통과(4+9+6+1), failures/errors/skipped 모두 0. context 매 테스트 재생성, 실제 DB 잠금·동시성, JPA 조회와 DB 수명을 검증했다.- 승인된 전체 실행:
./gradlew --no-daemon test --console=plain진행 중. 결과와 GC 효과는 아직 확정하지 않는다. - 전체 실행 결과: exit 1, 17분 47.442초, 신규 XML 398개/3,752 tests/6 failures/0 skipped/0 errors. 실패는 OriginalWorkReadRetryTest 6개로 모두 H2
TRANSLATION_JOB또는ORIGINAL_WORK_TRANSLATION테이블 부재였다. 캐시 축소 시 공유 고정 DB 이름과 context 종료의 충돌 여부를 추적한다. - 전체 실행 GC(PID 55797): Full GC 2회/3.719242초, GC pause 총 1,359회/24.221353초. 마지막 GC 후 4,085MiB, 최대 GC 후 4,089MiB로 4,096MiB 한도 근접. 완주는 확인했지만 테스트 증가에 대한 여유가 충분하지 않아 worker 주기적 교체 실험이 필요하다. 어떤 객체가 잔존 힙 대부분을 보유하는지는 아직 미확인이다.
- 1차 변경 리뷰 APPROVE. 이후 발견한 suite 실패와 worker 정책 변경은 별도 delta 리뷰 대상으로 남긴다.
P2-R1: suite에서 드러난 DB 격리와 누적 메모리 보호
- MetadataReadRetryTestSupport의 고정 DB 이름 충돌을 runtime chronology로 확인하고 focused 재현/수정.
- worker 50클래스 단위 교체를 초기 실험값으로 적용하여 JVM별 누적을 제한하고 GC 로그로 효과 확인.
- 전체 재검증, 추가 변경 delta 리뷰와 최종 기록.
- worker 교체는 잔존 객체의 root cause 수정으로 주장하지 않으며, 프로세스 수명에 의한 보호 장치로 구분한다.
src/test/kotlin/kr/co/vividnext/sodalive/i18n/translation/MetadataReadRetryContextIsolationTest.kt에서 실제 원작·커뮤니티 test context를 함께 로드하고, 커뮤니티 context 종료 후 원작 repository의 저장 작업 보존을 검증한다. CreatorCommunityReadRetryTest는 추가@Import와@MockBean때문에 별도 context를 만들지만 공통 support의 고정 DB 이름을 공유한다.- 번역 패키지 단독 실행은 1분 3초에 통과했지만, Gradle이 직전 실패 OriginalWork 클래스를 맨 먼저 실행했다. 따라서 이 성공만으로 전체 실행 순서에서 발생한 격리 오류가 해결됐다고 판단하지 않는다. 새 회귀 테스트는 순서에 의존하지 않고 context 충돌을 직접 재현한다.
- 격리 RED:
./gradlew --no-daemon test --tests '*MetadataReadRetryContextIsolationTest' --console=plain, exit 1, 50초. 커뮤니티 context를 닫은 뒤 원작 repository 조회가InvalidDataAccessResourceUsageException → SQLGrammarException → JdbcSQLSyntaxErrorException로 실패했다. 실제 두 context 종료 경계에서 테이블 손실을 재현했다. - 최소 수정은
MetadataReadRetryTestSupport.kt의 DB 이름에\${random.uuid}를 붙이는 것이다. 기존 상속 context 구성과 transaction/fixture/assertion은 유지한다. - 격리 GREEN:
./gradlew --no-daemon test --tests '*MetadataReadRetryContextIsolationTest' --tests 'kr.co.vividnext.sodalive.i18n.translation.*ReadRetryTest' --console=plain, exit 0, 1분 24초. 재현 테스트와 관련 6개 클래스가 함께 통과했다. 이 실행까지forkEvery를 적용하지 않아 프로세스 분리로 격리 문제를 감추지 않았다. forkEvery = 50을 이제 적용한다. 한 JVM을 무제한 재사용한 실행의 마지막 GC 후 힙 4,085MiB를 근거로 누적 기간을 제한하는 초기 실험값이다. 전체 실행에서 실제 PID 교체·최대 GC 후 힙·완료 시간을 확인하고 유지 여부를 판단한다.- 격리 수정 후 lint 재검증은 단독 명령 120초 제한에 걸렸다.
jps -l에서 소유 프로세스가 남지 않았음을 확인했다. 다음 단일 명령에서 lint와 전체 suite를 함께 검증한다:./gradlew --no-daemon ktlintKotlinScriptCheck ktlintTestSourceSetCheck test --console=plain.
최종 산출물 확인
- 최종 명령의 background session 결과가 연결 복구 후 사라져 원본 종료 코드와 전체 wall-clock 시간은 복구하지 못했다. 이미 완료된 테스트를 다시 실행하지 않고 남아 있는 HTML/XML/GC 산출물을 직접 대조했다.
build/reports/tests/test/index.html: 3,753 tests, 0 failures, 0 ignored, 100% successful. XML 399개 독립 집계도 3,753 tests/0 failures/0 errors/0 skipped. 기존 실패 OriginalWork 6개와 새 DB 수명·context 격리 테스트 모두 전체 실행에서 통과했다.- HTML의
2m41.62s는 테스트 duration 합계이며 context 초기화 등을 포함한 전체 명령 시간으로 보고하지 않는다. - 최종 Kotlin script/test source lint 보고서 둘 다 위반 항목 0개. 최종 command exit 원본은 없으며, 이전 단계의 lint exit 0 기록과 구분한다.
git diff --check도 통과했다. - 최종 worker PID: 62402, 62915, 63240, 63535, 63748, 63967, 64349, 64724, 64965, 65131, 65315, 65472, 65570. 13개 GC 로그 모두
heap,exit가 있고 Full GC 0회다. - PID별 최대 GC 후 힙(MiB): 1130, 886, 1257, 722, 861, 1392, 1464, 1112, 540, 630, 730, 379, 720. 전체 최대 1,464MiB로 교체 전 실행의 4,089MiB보다 낮다. heap 한도 4,096MiB는 증가시키지 않았다. GC 전후 힙 값이 있는 pause 행 합계는 18.963초이며, 이 값은 heap 전후 값 없는 pause를 포함한 전체 GC 시간과 구분한다.
- worker 50클래스 교체는 관측된 누적을 제한하는 보호 장치로 유지한다. 모든 향후 단일 테스트의 메모리/무한 대기까지 보장하거나, 잔존 객체의 근본 원인이 모두 밝혀졌다고 주장하지 않는다.
- 현재
jps -l에 테스트 worker가 없고 작업용 승인 temp parent 디렉터리는 비어 있다. 작업 노트와 소유 temp root는 삭제했다. XML/HTML과 GC 로그는 검증 근거로 build 아래 보존한다. - 최종 delta 리뷰 재확인: APPROVE, 차단 사유 없음. UUID DB 격리, 실제 두 context 생성·종료 회귀와 finally 정리, worker 50클래스 교체와 캐시 4개 정책을 확인했다. 고정 DB RED/UUID GREEN을 fork 도입 전에 증명한 점을 확인했다. 최종 suite 및 GC 결과와 함께 완료 처리하며 추가 테스트 재실행은 하지 않는다.
- 운영 코드 변경, 테스트 삭제/skip/검증 완화, commit/push는 없다. 기존 사용자 staged 변경은 보존했다. Kotlin LSP는 기존 미설치 상태여서 사용하지 않았으며 실제 Gradle 테스트 컴파일·실행과 lint 산출물로 검증했다.
P3: 승인된 SQL 출력 및 context 재사용 최적화 (2026-11-19)
- 관측 기준: 최종 전체 worker 구간 1,399.703초, Spring 시작 182회. 중복 제거한 실제 Starting→Started 구간 합계 1,158.593초. stdout 227,792,396 bytes 중 SQL 블록 추정 179,790,139 bytes. 세 클래스 추가 초기화 14회/81.541초는 절감 후보이며 확정 절감량이 아니다.
- 수정 경로:
src/test/resources/application.yml,src/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/all/adapter/in/web/MainContentAllEndToEndTest.kt,src/test/kotlin/kr/co/vividnext/sodalive/v2/api/content/overview/adapter/in/web/ContentOverviewEndToEndTest.kt,src/test/kotlin/kr/co/vividnext/sodalive/content/series/main/banner/ContentSeriesBannerServiceIntegrationTest.kt. - 범위 밖: 운영 코드, 기존 assertion 삭제/완화, 테스트 전체 Transactional 적용, 캐시/worker/heap 조정, 기존 사용자 staged 변경, commit/push.
P3-T1: SQL 출력 비교
- 변경 전 동일 focused 4클래스 실행으로 GREEN baseline과 시간/stdout/context 횟수 기록.
- SQL 출력과 포맷만 끈 뒤 동일 명령으로 통과와 실제 출력 감소 확인.
P3-T2: context 재사용과 상태 정리
- 세 클래스의 DB FK/직접·간접 side effect를 확인한다.
- 메서드별 context 재생성을 해당 클래스의 fixture 정리로 바꾼다. HTTP/서비스 호출의 트랜잭션 경계와 OSIV off는 그대로 둔다.
- 같은 focused 실행으로 25개 기존 테스트 통과, 시작 횟수 감소, 누적 데이터 없음과 성능 비교를 확인한다.
- 정리 실패가 기존 assertion에서 드러나는지 검토하고 관련 회귀·lint·단일 게이트 리뷰를 수행한다.
검증 명령
./gradlew --no-daemon test --tests '*MainContentAllEndToEndTest' --tests '*ContentOverviewEndToEndTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --tests '*AdminTranslationSelectionContentsHttpIntegrationTest' --console=plain
- SQL 집중 클래스는 설정 영향 측정 대상으로만 실행하며 소스는 수정하지 않는다.
- 전체 테스트는 이번 최적화의 자동 검증으로 반복하지 않는다. 직접 영향 기능별 검증을 수행하고 전체 재실행 여부는 최종 보고에 구분한다.
- 비교 기록과 소유 임시 자원 정리 완료.
P3 측정 기록
- 변경 전 baseline: 위 focused 명령 exit 0, shell wall 526초(Gradle 8분 45초), 25 tests/0 failures. stdout 104,015,806 bytes,
Hibernate:140,318회, Spring 시작 18회/시작 로그 시간 합계 376.851초, testcase 시간 합계 66.206초. - SQL-only 변경은 공통 YAML의
hibernate.show_sql,hibernate.format_sql두 값을 false로 바꾼다. 테스트 소스와 worker/cache 설정은 이 단계에서 변경하지 않는다. 다음 실행에서 실제 SQL 출력이 사라졌는지 확인한다. - SQL-only 결과: 동일 명령 exit 0, shell wall 373초(Gradle 6분 12초), 25/25 통과. stdout 4,655,102 bytes,
Hibernate:0회, Spring 시작 18회/288.724초, testcase 합계 28.514초. 출력 감소를 실제로 확인했다. 시간은 같은 환경 연속 실행의 단일 관측이며 캐시/부하 변동을 배제한 보장값으로 해석하지 않는다. - context 변경: 세 클래스의 method-level DirtiesContext를 제거하고 AfterEach에서 각 전용 DB의 fixture 테이블만 FK 자식→부모 순서로 삭제한다.
series_published_days_of_week는 series보다 먼저 제거한다. overview 응답에 items 정확히 1개 assertion을 추가해 이전 fixture 노출도 감지한다. 기존 HTTP/서비스 호출은 테스트 transaction 밖에 유지한다. - 첫 reuse 실행 exit 1, 227초, overview 6개 실패. 인증 조회의
MemberContentPreferenceService.resolveForQuery/getStoredPreference가 기본 preference를 저장하는 실제 부작용을 정리 목록에서 놓쳤다.member_content_preference.member_id → member.idFK 위반으로 정리 transaction이 rollback됐고 새 items=1 assertion이 누적된 3/5개 항목을 검출했다. 해당 테이블을 member보다 먼저 정리하도록 보완한다. 기존 조회/OSIV/트랜잭션 동작은 바꾸지 않는다. - 보완 후 reuse 결과: 같은 focused 명령 exit 0, shell wall 282초(Gradle 4분 42초), 25/25 통과. stdout 872,482 bytes,
Hibernate:0회, Spring 시작 4회/168.083초, testcase 합계 28.979초. 대상 세 클래스가 각각 한 번만 시작했다. - baseline/SQL-only는 worker PID 95648/97025 한 개씩, 최종 reuse는 98759/98894/99190/99357 네 개였다. CLI와 fork/cache/heap 설정은 동일하지만 Gradle의 직전 실패 우선 실행과 class 배치가 달라 단일 wall-time 차이를 통제된 인과 추정으로 주장하지 않는다. 출력 제거와 14회 context 재생성 제거는 로그로 직접 확인했다.
- 추가 검증: owned temp init script에서 JUnit MethodOrderer.Random 및 seed 20261119를 적용해 세 클래스의 메서드 순서를 변경한다. committed fixture cleanup이 순서 독립성을 유지하는지 확인하며 script는 종료 시 제거한다.
- 순서 변경·lint 실행:
./gradlew --no-daemon -I /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/test-speed.slsAQM/random-method-order.gradle ktlintKotlinScriptCheck ktlintTestSourceSetCheck test --tests '*MainContentAllEndToEndTest' --tests '*ContentOverviewEndToEndTest' --tests '*ContentSeriesBannerServiceIntegrationTest' --console=plain, exit 0, 4분 44초. XML 3개/17 tests/0 failures/0 errors/0 skipped. 순서 변경과 병행한 lint 실행은 성능 비교 표본으로 사용하지 않는다. 해당 임시 script는 검증 후 제거했다. - 독립 P3 리뷰 APPROVE: FK 삭제 순서, 간접 생성 preference 정리, 전용 datasource, 기존 statistics/HTTP/commit/OSIV 경계 보존 확인. 정리 실패 때 기존/추가 assertion이 누적 데이터를 검출한 실행 근거도 유지했다.
- P3 후 전체 테스트는 재실행하지 않았다. 앞선 P2의 3,753개 통과와 현재 focused 25개/순서 변경 17개를 구분한다. 사용자 전체 검증 명령:
./gradlew test. - 최종
jps -l에 테스트 worker가 없음을 확인했다. 임시 init script·노트·owned root를 정리하고 측정값은 이 문서에 보존한다. 코드·assertion 삭제/skip, 운영 코드 변경, commit/push는 없다.
| P3 단계 | shell wall | tests | stdout bytes | Hibernate 표식 | Spring 시작 |
|---|---|---|---|---|---|
| 변경 전 | 526초 | 25 PASS | 104,015,806 | 140,318 | 18 |
| SQL 출력 off | 373초 | 25 PASS | 4,655,102 | 0 | 18 |
| context 재사용·fixture 정리 | 282초 | 25 PASS | 872,482 | 0 | 4 |
동일 명령의 관측 결과로 244초 단축됐지만, 단일 연속 실행과 worker 배치 차이가 있어 전체 suite 단축률이나 동일 환경 반복 실행의 보장값으로 확대하지 않는다.
P4: 승인된 실행 시 테스트 힙 자동 산정
- 시작 조건: 사용자 적용 승인. 기존 변경과 staged 사용자 파일은 보존한다.
- OS 관측: 실제 Liberica17 probe에서 total 34,359,738,368 bytes, free 1,110,003,712 bytes. Darwin JDK 구현은 free_count만 사용해 inactive/speculative를 가용 추정에 반영하지 않는다.
vm_stat은 4,096-byte page, free 282,532 pages, inactive 3,161,273 pages, speculative 5,015 pages를 별도로 보고했다. - OS별 관측 의미와 보수적 예산 계산 정책 확정 및 테스트 가능한 최소 build logic 위치 결정.
- 산정 경계, worker 분배, 잘못된 관측, 부족 예산에 대한 자동 테스트 RED/GREEN.
- Test task 실행 직전 산정과 명시적 maxHeapSize 연결. 실제 worker launch/GC maximum 확인.
- 메모리 부족 거부 경로를 실제 시스템 메모리 압박 없이 검증.
- focused/lint/리뷰, 사용법·한계 문서, 소유 임시 probe와 노트/root 정리.
- 범위 밖: 운영 코드·앱 의존성 변경, 테스트 누락/skip/실패 무시, 전체 suite 자동 반복, 실시간 heap resize, worker 동시성 확대, commit/push.
P4 확정 설계
- build logic는 Java-only
buildSrc의 단일buildlogic.TestHeapPolicy와 JUnit 5.8.2 경계 테스트로 분리한다. 애플리케이션 classpath에 넣지 않고 Kotlin DSL 플러그인도 추가하지 않는다. 파일은buildSrc/build.gradle.kts,buildSrc/src/main/java/buildlogic/TestHeapPolicy.java,buildSrc/src/test/java/buildlogic/TestHeapPolicyTest.java, 루트build.gradle.kts, 실행 가이드와 기존 작업 문서다. - macOS 가용 추정은
vm_stat의(Pages free + Pages inactive) × page size다. psutil 7.0.0_psosx.py원문을 직접 대조해avail = inactive + free계산이free -= speculative보다 먼저 수행됨을 확인했다. speculative/file-backed를 별도로 더하거나 speculative을 빼지 않는다. 출처: https://github.com/giampaolo/psutil/blob/release-7.0.0/psutil/_psosx.py . 이는 회수 가능량의 추정이지 OS의 할당 보장이 아니다. - macOS 외에는 JDK 17 OperatingSystemMXBean의 free memory를 보수적 관측값으로 사용한다. 해당 JDK/OS의 container 인식 범위를 넘는 host 추정을 추가하지 않는다. 이 경로의 실제 OS별 실행 검증은 현재 Mac에서 수행할 수 없다는 한계를 기록한다.
- 정책: 가용 추정 A의 절반을 시스템 여유로 남긴다. 유효 worker F=
min(maxParallelForks, maxWorkers)로 나눈 뒤 worker당 힙 외 1GiB를 제외하고 MiB 단위로 내린다.heapMiB = floor((floor(floor(A/2)/F) - 1GiB)/1MiB). 4,096MiB 미만이면 올려 할당하지 않고 명시적 실패다. - 메모리 관측은 Test task doFirst에서 한 번 수행한다. 이후 forkEvery로 교체한 worker도 그 task의 동일한 계산값을 사용한다. 구성만 읽는 help 작업은 OS 관측을 실행하지 않는다.
- 경계 검증: 10GiB/worker1과 20GiB/worker2의 정확한 하한, 1 byte 부족, fractional MiB 내림, 유효 worker cap, 4K/16K vm_stat page·누락/중복/음수/overflow, 잘못된 관측·worker 수를 검증한다.
- 실제 부족 예산 검증은 임시 init script로 root test task의 worker 요구량만 64로 높이고
--max-workers=64및 경량 테스트 한 클래스만 선택한다. 32GiB 호스트에서는 64개 worker의 각 4GiB 하한을 충족할 수 없어 시작 전에 실패해야 한다. 실제 메모리를 소모해 시스템 압박을 만드는 방식은 사용하지 않는다. 임시 설정은 검증 후 삭제한다.
P4 검증 기록
- buildSrc TDD:
./gradlew --no-daemon -p buildSrc test --tests 'buildlogic.TestHeapPolicyTest' --offline. 최소 구현 RED exit 1(51개 중 50개 assertion 실패), 구현 후 GREEN exit 0/6초/51 tests/0 failures/0 errors/0 skipped. 실제 macOS vm_stat 읽기도 포함한다. XML:buildSrc/build/test-results/test/TEST-buildlogic.TestHeapPolicyTest.xml. - root
./gradlew --no-daemon --offline help --console=plainexit 0/31초. Test task를 실행하지 않아 메모리 산정 로그와 vm_stat 실행이 없다. - 최초 실제 worker 검증은 buildSrc 추가로 Kotlin/KAPT task classpath가 바뀌어 재컴파일 중 300초 제한에 걸렸다. worker 시작 전이며,
jps -l에서 소유 프로세스 잔존이 없음을 확인하고 재개했다. 기존 소스의 컴파일 경고는 수정하거나 숨기지 않았다. - 재개:
./gradlew --no-daemon --offline test --tests '*H2DatabaseLifecycleTest' --tests '*MetadataReadRetryContextIsolationTest' --info --console=plain, exit 0/5분 4초. 두 테스트 모두 통과, failures/errors/skipped 0. - 실제 task-start 로그
available estimate=13432 MiB, workers=1, maxHeap=5692 MiB. worker 실행 인자-Xmx5692m와 PID 21951의build/test-gc/test/gc-21951.log의Heap Max Capacity: 5692M가 일치한다. 교체된 worker에도 동일한 상한이 전달됐다. 기본 512MB 또는 이전 고정 4GB로 실행되지 않았다. - 부족 예산 검증: 임시 init script와
--max-workers=64,--tests '*CodePointTextSplitterTest'로 실행. 예상대로 exit 1/16초,Insufficient test memory: availableBytes=15350431744, effectiveWorkers=64, minimumHeapMiB=4096가 출력됐고 root Test Executor/class 시작 없이 종료했다. 실제 메모리 압박은 만들지 않았다. - 현재 macOS 실행만 검증했다. 비macOS JDK free-memory 경로 및 vm_stat timeout/interruption 강제 재현은 미검증이다. 전체 애플리케이션 suite는 P4 후 재실행하지 않는다.
./gradlew --no-daemon --offline ktlintKotlinScriptCheck --console=plainexit 0/17초.git diff --check통과. 실제 실행 후jps -l에 소유 테스트 worker가 없음을 확인했다. 기존 Gradle daemon과 IDE는 유지한다.- 임시 JVM 관측 probe, 부족 예산 init script와 실행 노트를 삭제하고 owned root를 정리한다. 계산식/검증 결과는 이 문서에 남긴다. 앱 코드 및 기존 테스트 파일은 P4에서 수정하지 않았다.
- 최종 독립 리뷰 APPROVE: raw free+inactive 계산, 예산/worker cap/내림/4GiB 하한, parser 오류와 프로세스 정리, doFirst 연결 및 별도 buildSrc 테스트 범위를 확인했다. 비macOS와 강제 timeout/interruption은 미검증으로 유지한다.
- 소유 임시 root 삭제와 부재 확인 완료. 추가 재검증 없이 종료하며 commit/push는 수행하지 않았다.