Repository navigation
ELOG 034 e2e proxy leak two dead ends
| 항목 | 내용 |
|---|---|
| 분류 | 🔧 트러블슈팅 |
| 날짜 | 2026-09-06 |
| 영역 | FE |
| 관련 이슈/PR | #1355, #1356 |
| 상태 | 해결 |
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 로그에서 한 것과 같은 문제다. 통과한 실행의 로그가 에러로 가득하면, 진짜 실패가 났을 때 그 안에서 골라낼 수 없다.
vite dev 서버는 /api를 localhost:8080으로 프록시한다. CI에는 그 자리에 BE가 없다. 그래서 page.route로 막지 않은 요청만 프록시를 타고 나가 ECONNREFUSED가 된다.
55줄이 한 경로에 몰린 이유는 단순했다. 사이드바가 모든 화면에서 복습 요약을 부르는데, 30개 스펙 중 12개가 그걸 막지 않는다(note-* 10개, offline, service-worker, travel-leg-editor). 그 스펙들은 페이지를 열 때마다 한 줄씩 남겼다.
스펙마다 빠진 mock을 채우는 길도 있지만, 새 스펙이 생길 때마다 같은 일이 반복된다. 막지 않은 /api를 공용 픽스처에서 그물로 받는 편이 낫다고 보고 착수했다 — 그리고 두 번 틀렸다.
그물의 첫 구현은 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 픽스처를 만들 때(= 스펙의 훅보다 먼저) 걸리기 때문이다.
변경 후 실행(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) |
-
가짜로 바꿀 때 바꾸지 말아야 할 것은 「앱이 보는 것」이다. 여기서 그것은 실패의 존재가 아니라 실패의 모양이었다 — 응답 없음(
abort)과 HTTP 500은 앱에게 다른 사건이다. 무엇을 흉내 낼지 정하기 전에 진짜가 무엇을 주고 있었는지부터 봐야 한다(vite 소스 한 줄로 끝났다). -
저장소가 이미 답을 적어 둔 곳부터 읽는다. 글로브 함정은
auth.spec.ts주석에 그대로 있었다. 같은 영역에 손대기 전에 그 영역의 기존 주석을 읽는 것이 5분짜리 전체 실행보다 싸다. ELOG-033에서도 로그 패턴 하나가 오진을 갈랐는데, 이번엔 주석 하나였다. - 테스트가 그물에 걸려 깨지면 스펙이 아니라 그물을 의심한다. 오프라인 테스트가 깨진 것은 그 테스트가 낡아서가 아니라, 그물이 그 테스트의 주제를 지워서였다. 시험 대상이 네트워크인 스펙에는 네트워크 목을 씌우지 않는다 — opt-out 하나가 그 경계다.
- 남은 2줄처럼 원리적으로 못 없애는 잔여는 없애는 척하지 말고 이유와 함께 남긴다. 서비스 워커가 낸 요청은
page.route가 닿지 않는다.
- 이슈 #1355 · PR #1356
- 변경 전 CI run 33984233213 / 변경 후 run 34007580639
- ELOG-033 — 같은 주에 BE 빌드 로그에서 한 같은 종류의 작업
- Test Strategy — FE는 API 레벨에서만 목을 둔다는 원칙