FAQ

병렬 재생 테스트가 가끔 실제 백엔드를 호출합니다. 왜 그런가요?

아마도 테스트별 훅에서 playwrightProxy.teardown()을 호출하고 있을 것입니다. 이것은 전역 프록시 모드를 transparent로 설정하며, fullyParallel: true에서는 각 Playwright 워커가 자체 test.afterAll을 실행합니다. 빠른 테스트가 끝나서 teardown()을 호출하는 동안 느린 테스트가 계속 실행 중이라면, 프록시가 테스트 도중에 transparent로 전환되어 나머지 요청이 재생되는 대신 실제 백엔드로 전달됩니다.

// ❌ 병렬 재생을 깨뜨림 — teardown()은 모든 세션에 전역으로 영향을 줌
test.afterAll(async () => {
  await playwrightProxy.teardown();
});

해결책: test.afterAll을 제거하세요. 세션 정리는 context.on('close') → cleanupSession()으로 자동으로 이루어집니다. 전역 티어다운은 전체 실행 후 프록시를 재설정해야 할 때만 사용하세요.

기록을 git에 커밋해야 하나요?

네. CI가 네트워크 없이 재생할 수 있도록 기록은 git에 있어야 합니다. e2e/recordings를 .gitignore에 추가하지 마세요. 큰 기록 파일이 PR diff를 비대하게 만드는 것을 막으려면 .gitattributes에서 바이너리로 표시하세요.

/e2e/recordings/** binary

프록시 <target-url>이 브라우저 전용(HAR) 기록에 중요합니까?

아니요. 브라우저 전용 기록에서는 대상이 무관합니다. 세션 관리를 위해 /__control 엔드포인트를 사용할 수 있도록 프록시 프로세스가 실행 중이기만 하면 됩니다. 대상은 서버 측(SSR) 요청도 프록시를 통과할 때만 중요합니다.

Next.js 개발 서버로 기록할 수 있나요?

기록과 재생에는 next dev보다 next build + next start를 선호하세요. 개발 서버는 느리고 시간 초과나 불안정한 기록을 유발할 수 있습니다.

기록을 어떻게 갱신하나요?

실제 API를 대상으로 기록 모드로 다시 실행하고(픽스처에서 MODE = 'record'로 설정하거나 RECORD_MODE=1), 다시 재생으로 전환한 뒤 e2e/recordings/의 갱신된 파일을 커밋하세요.