Skip to content

[Test] RAG claim 행 잠금 통합 시험이 다른 Context의 RAG Worker와 경합하는 문제 - #522

Merged
Gimini-3 merged 2 commits into
developfrom
test/520
Oct 16, 2026
Merged

Gimini-3 merged 2 commits into
developfrom
test/520

Conversation

@Gimini-3

Copy link
Copy Markdown
Contributor

🔍️ 작업 내용

RagResponseClaimIntegrationTest가 CI에서 간헐적으로 실패하던 원인은 다른 시험 Context의 RAG Worker였습니다. 이 Worker가 공용 test 스키마를 polling하며 시험이 만든 작업을 먼저 가져갔습니다. 수정으로 이 시험 클래스만 전용 스키마를 쓰게 했고, 운영 코드는 바꾸지 않았습니다.
경합 창을 넓힌 강제 조건에서 수정 전 20회 중 20회 실패, 수정 후 20회 모두 통과했습니다. 격리 DB의 전체 백엔드 clean build는 1,501건 중 실패·오류 0건이었습니다.

✨ 상세 설명

  • 원인
    • 이 클래스는 @MockitoBean RagJobWorker로 자기 Context의 Worker만 막습니다([Fix] RAG 작업 claim에 lease와 소유권 토큰 적용 #515).
    • Spring 테스트 Context 캐시에 남은 다른 시험 Context(기본 Context)의 RagJobWorker는 1초마다 같은 test 스키마의 PROCESSING 행을 같은 쿼리로 claim합니다.
    • 외부 Worker가 먼저 가져가면 첫 트랜잭션이 잠글 행이 없어 orElseThrow로 끝납니다. 그러면 latch가 내려가지 않아 138행이 10초 뒤 실패합니다.
    • CI 로그에서도 Context 기동 51ms 뒤 rag-worker-job-1 스레드 두 개가 이 시험의 queryId 5·6을 처리했습니다.
  • 같은 원인의 두 번째 시험: 같은 클래스의 claim_allowsExactlyOneConcurrentOwner도 두 claim이 모두 빈 결과가 될 수 있습니다. 자연 반복 실행에서 한 번 재현했습니다.
  • 변경: @DynamicPropertySource로 TEST_DB_SCHEMA를 <기존값>_rag_claim으로 바꿉니다(시험 파일 11줄 추가).
    • application-test.yml의 접속 URL과 Flyway 설정이 모두 이 값을 따르므로 다른 설정은 손대지 않았습니다.
    • 새 스키마 마이그레이션 53건은 0.4~0.5초 걸립니다.
  • 검토한 다른 방법
    • test 프로필에서 RAG Worker 끄기: RagJobWorker에 조건부 설정(운영 코드)이 필요합니다. 실제 Worker를 쓰는 시험 두 개도 따로 켜고 Context를 닫아야 합니다.
    • 시험 데이터 구분: 외부 Worker와 같은 쿼리라 행만으로는 구분되지 않습니다.

🧪 실제 검증 결과

환경: 로컬 macOS arm64·OpenJDK 17.0.18, 새 격리 PostgreSQL 17.8·pgvector 0.8.1·Valkey 9.1 컨테이너(사용자 로컬 DB 미사용). Ollama는 CI처럼 띄우지 않았습니다. 기준은 develop 37b08a4(#519 병합 후)입니다.

실행 시험 파일 실행·실패 관측 결과
forced-before-10 수정 전 20·20 작업 생성 뒤 1.5초 대기 조건. 두 시험 모두 매번 실패, 외부 Worker 로그 60줄
forced-after-10 수정 후 20·0 같은 조건에서 통과, 외부 Worker 로그 0줄
natural-before 수정 전 1,400·1 200·500회 반복. claim 시험 1회 실패(성공 claim 0건)
natural-after-500 수정 후 1,000·0 통과
full-build-02 수정 후 1,501·0 (건너뜀 5) CI와 같은 clean build, 251개 묶음, 1분 29초
  • 반복 실행은 CI와 같은 클래스 순서(실제 Worker가 켜진 두 클래스 뒤)로 돌렸습니다.
  • 첫 전체 빌드(full-build-01)에서는 무관한 StompSessionLifecycleIntegrationTest의 JWT 만료 시험 1건이 실패했습니다. 수명 1초 JWT의 exp가 초 단위로 잘려, 구독 확인보다 세션 종료가 먼저 올 수 있는 타이밍 문제로 보입니다. 새 컨테이너로 다시 돌린 full-build-02에서는 통과했습니다.
  • 격리 컨테이너는 삭제했습니다.
  • 실행별 발췌·JUnit 요약·반복 스크립트

🛠️ 추후 리팩토링 및 고도화 계획

  • 다른 Context의 Worker는 그대로 공용 test 스키마를 polling합니다. 앞으로 PROCESSING RAG 작업을 만들고 claim 순서를 단언하는 시험을 추가하면 같은 격리가 필요합니다.
  • STOMP JWT 만료 시험의 간헐 실패는 별도로 확인합니다.

💬 리뷰 요구사항

  • 로컬에서 실행하면 <TEST_DB_SCHEMA>_rag_claim 스키마가 DB에 남습니다(다음 실행에서 재사용). 이 방식이 괜찮은지 봐 주세요.

Context 캐시에 남은 다른 시험 Context의 RagJobWorker가 공용 test 스키마를 polling하며 이 시험의 작업을 먼저 claim했다. 이 클래스만 TEST_DB_SCHEMA에 _rag_claim을 붙인 전용 스키마를 쓴다.

Refs #520
@Gimini-3 Gimini-3 added the 🧪 Test 테스트 label Oct 16, 2026
@Gimini-3 Gimini-3 self-assigned this Oct 16, 2026
@coderabbitai

coderabbitai Bot commented Oct 16, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: Repository: DocGrid/docgrid/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: dd777fd2-6377-479b-907d-5c379ec9aff8
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🧪 Test 테스트

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Test] RAG claim 행 잠금 통합 시험이 다른 Context의 RAG Worker와 경합하는 문제

1 participant