CI 테스트가 로컬에선 통과하는데 파이프라인에선 가끔 실패합니다(플래키)

Question

CI에서 테스트가 무작위로 실패합니다. 재실행하면 통과하고, 로컬에선 항상 성공합니다. 실패 테스트도 매번 다릅니다. 어디서부터 봐야 하나요?

환경: GitHub Actions, 병렬 테스트

김영삼 · Accepted Answer

전형적인 플래키 테스트입니다. "무작위·재실행 통과·로컬만 성공"이면 원인은 대개 정해져 있습니다. 테스트 간 상태 공유 — 전역/DB/파일을 공유하고 병렬 실행 시 서로 간섭. 각 테스트가 독립 픽스처를 쓰게 격리하세요. 실행 순서 의존 — A가 만든 데이터를 B가 기대. 순서 랜덤화로 의존성을 드러내 고치세요. 시간·타이밍 — sleep 고정 대기, 현재 시각·타임존 의존. 고정 시계(clock mock)와 "조건 만족까지 대기(polling)"로 바꾸세요. 비동기 경쟁 — await 누락, 정리(teardown) 전에 다음 테스트 시작. 외부 의존 — 네트워크·시간 동기화. 모킹하거나 격리. 잡는 방법: CI에서 테스트 순서를 랜덤 시드로 섞고, 실패 시 시드를 로그에 남겨 재현하세요. 로컬에서도 같은 시드 + 병렬도를 CI와 동일하게 주면 재현됩니다. 로컬이 항상 통과하는 건 보통 직렬 실행이거나 깨끗한 상태에서 돌려서입니다.

댓글 0