Skip to content

ELOG 034 e2e proxy leak two dead ends

wcorn edited this page Sep 6, 2026 · 1 revision

ELOG-034: E2E 로그를 덮던 프록시 에러 62줄 — 그리고 두 번의 헛짚음

항목 내용
분류 🔧 트러블슈팅
날짜 2026-09-06
영역 FE
관련 이슈/PR #1355, #1356
상태 해결

1. 상황 (Before)

FE CI의 E2E 잡이 133개 전부 통과하는데 로그는 프록시 에러로 덮여 있었다.

[WebServer] 6:31:20 PM [vite] http proxy error: /api/planner/reviews/summary
[WebServer] AggregateError [ECONNREFUSED]:
[WebServer]     at internalConnectMultiple (node:net:1135:18)

변경 전 실행(run 33984233213)의 실측 — 총 62줄:

경로 건수
/api/planner/reviews/summary 55
/api/travel/summary 5
/api/travel/places/search 1
/api/travel/activities/1 1

ELOG-033이 BE 로그에서 한 것과 같은 문제다. 통과한 실행의 로그가 에러로 가득하면, 진짜 실패가 났을 때 그 안에서 골라낼 수 없다.

2. 원인 분석

vite dev 서버는 /api를 localhost:8080으로 프록시한다. CI에는 그 자리에 BE가 없다. 그래서 page.route로 막지 않은 요청만 프록시를 타고 나가 ECONNREFUSED가 된다.

55줄이 한 경로에 몰린 이유는 단순했다. 사이드바가 모든 화면에서 복습 요약을 부르는데, 30개 스펙 중 12개가 그걸 막지 않는다(note-* 10개, offline, service-worker, travel-leg-editor). 그 스펙들은 페이지를 열 때마다 한 줄씩 남겼다.

스펙마다 빠진 mock을 채우는 길도 있지만, 새 스펙이 생길 때마다 같은 일이 반복된다. 막지 않은 /api를 공용 픽스처에서 그물로 받는 편이 낫다고 보고 착수했다 — 그리고 두 번 틀렸다.

3. 조치 (그리고 두 번의 헛짚음)

헛짚음 ① — 연결 거부로 막았다

그물의 첫 구현은 route.abort("connectionrefused")였다. "지금 나는 것과 똑같은 실패를 브라우저 안에서 만들면 된다"고 생각했다.

전체 E2E 결과 16 passed / 116 failed. 랜딩 페이지의 getByText("orino")부터 찾지 못했다 — 앱이 아예 부팅하지 않았다.

앱이 지금까지 보던 것은 연결 거부가 아니었다. vite가 프록시 에러를 대신 받아 HTTP 응답으로 바꿔 주고 있었다. 소스에서 확인:

// vite/dist/node/chunks/config.js
if (!res.headersSent && !res.writableEnded)
  res.writeHead(500, { "Content-Type": "text/plain" }).end();

즉 앱은 500 text/plain 빈 본문을 받아 왔다. 응답이 아예 없는 것(abort)과는 다른 상황이고, 앱의 부팅 경로가 그 차이에 걸렸다. 그물이 돌려줄 것을 이 500으로 맞췄다.

헛짚음 ② — 글로브가 앱 소스까지 삼켰다

500으로 바꿔도 15 passed / 117 failed, 증상은 그대로였다. 원인은 응답이 아니라 무엇을 가로챘는가였다.

그물의 패턴이 **/api/**였는데, dev 서버는 앱 소스를 URL로 서빙한다 — /src/shared/api/client.ts. 그 경로에도 /api/가 들어 있어 앱 번들이 통째로 가로채였다. 화면이 안 뜬 게 당연하다.

그리고 이건 이미 저장소에 적혀 있었다. auth.spec.ts의 주석:

막는 방법에 주의: 글로브 **/api/**는 dev에서 앱 소스(/src/shared/api/client.ts)까지 삼켜 화면이 아예 안 뜬다. 경로 술어로 잡는다.

같은 파일이 같은 이유로 이미 술어를 쓰고 있었다. 먼저 읽었으면 한 번의 전체 실행(5분)을 아꼈다. 술어로 바꾸니 131 passed / 1 failed.

남은 하나 — 그물을 씌우면 안 되는 스펙

마지막 실패는 offline.spec.ts의 「로그인한 채 오프라인에서 새로고침해도 로그인 화면으로 쫓겨나지 않는다」였다.

이건 그물이 만든 실패이고, 고칠 것은 그물 쪽이었다. 앱은 「망이 끊긴 것」과 「서버가 거절한 것」을 다르게 다룬다 — 끊김이면 세션을 지키고, 거절이면 로그아웃시킨다. 그 구분을 확인하는 것이 저 테스트의 주제인데, 그물이 오프라인에서도 500을 만들어 주니 재발급이 거절로 보여 로그인 화면으로 튕겼다.

네트워크를 시험하는 스펙에 네트워크를 흉내 낸 그물을 씌우는 것은 앞뒤가 맞지 않는다. 옵션 픽스처로 그 스펙만 껐다.

// e2e/support/test.ts
export const test = base.extend<{ stubUnmockedApi: boolean }>({
  stubUnmockedApi: [true, { option: true }],
  page: async ({ page, stubUnmockedApi }, run) => {
    if (stubUnmockedApi) {
      await page.route(
        (url) => url.pathname.startsWith("/api/"),
        (route) =>
          route.fulfill({ status: 500, contentType: "text/plain", body: "" }),
      );
    }
    await run(page);
  },
});

// e2e/offline.spec.ts
test.use({ stubUnmockedApi: false });

스펙이 나중에 거는 라우트는 그대로 이긴다. Playwright가 라우트를 _routes.unshift()로 쌓아 나중에 등록된 것을 먼저 맞춰 보고(playwright-core/lib/client/page.js), 이 그물은 page 픽스처를 만들 때(= 스펙의 훅보다 먼저) 걸리기 때문이다.

4. 결과 (After)

변경 후 실행(run 34007580639) — 133 passed, 프록시 에러 62줄 → 2줄.

경로 전 후
/api/planner/reviews/summary 55 0
/api/travel/summary 5 1
/api/travel/places/search 1 1
/api/travel/activities/1 1 0

남은 2줄은 그물을 끈 offline.spec이 서비스 워커를 통해 실제로 내보내는 요청이다. 서비스 워커가 낸 요청은 page.route로 가로채이지 않고, 그 스펙은 진짜 네트워크를 써야 성립한다 — 지우는 대신 이유를 주석에 남겼다.

시도별 전체 실행 결과(전부 로컬 3개 프로젝트 전량):

시도 그물 결과
① abort + 글로브 16 passed / 116 failed
② 500 + 글로브 15 passed / 117 failed
③ 500 + 경로 술어 131 passed / 1 failed
④ ③ + 오프라인 opt-out 132 passed (CI 133)

5. 교훈 / 후속

  • 가짜로 바꿀 때 바꾸지 말아야 할 것은 「앱이 보는 것」이다. 여기서 그것은 실패의 존재가 아니라 실패의 모양이었다 — 응답 없음(abort)과 HTTP 500은 앱에게 다른 사건이다. 무엇을 흉내 낼지 정하기 전에 진짜가 무엇을 주고 있었는지부터 봐야 한다(vite 소스 한 줄로 끝났다).
  • 저장소가 이미 답을 적어 둔 곳부터 읽는다. 글로브 함정은 auth.spec.ts 주석에 그대로 있었다. 같은 영역에 손대기 전에 그 영역의 기존 주석을 읽는 것이 5분짜리 전체 실행보다 싸다. ELOG-033에서도 로그 패턴 하나가 오진을 갈랐는데, 이번엔 주석 하나였다.
  • 테스트가 그물에 걸려 깨지면 스펙이 아니라 그물을 의심한다. 오프라인 테스트가 깨진 것은 그 테스트가 낡아서가 아니라, 그물이 그 테스트의 주제를 지워서였다. 시험 대상이 네트워크인 스펙에는 네트워크 목을 씌우지 않는다 — opt-out 하나가 그 경계다.
  • 남은 2줄처럼 원리적으로 못 없애는 잔여는 없애는 척하지 말고 이유와 함께 남긴다. 서비스 워커가 낸 요청은 page.route가 닿지 않는다.

참고

Clone this wiki locally