Skip to content

ELOG 005 perf codesplit prefetch query

wcorn edited this page Jun 6, 2026 · 1 revision

ELOG-005: FE 로딩/체감 속도 + 자료 목록 쿼리 최적화

항목 내용
분류 ⚡ 성능 개선
날짜 2026-06
영역 FE (Vite/React/Tiptap) / BE (JPA)
관련 이슈/PR #443, #450, #453
상태 해결 (일부 모니터링)

인덱스로 돌아가기: Engineering Log

1. 상황 (Before)

"뭔가 느리다"는 피드백. 구체화하니 세 가지였다.

  1. 초기 번들이 큼 — 빌드 시 단일 청크 1,152 kB ("chunks larger than 500kB" 경고)
  2. 이미지 업로드 시 업로드 완료 후에야 이미지가 보임 (2.4MB면 수 초 빈 화면)
  3. 페이지 접근 시 컴포넌트가 늦게 뜸
  4. (실측) GET /api/planner/materials가 데이터가 거의 없는데 웜에서도 ~0.6초

2. 원인 분석

  • 번들: vite manualChunks 없음 + 라우트 코드 스플리팅 없음 → 모든 페이지 + Tiptap이 한 청크
  • 이미지: await uploadNoteImage() 완료 후 setImage → 업로드를 기다림
  • 페이지 지연: 라우트를 lazy로 분리(#443)했더니 초기 진입은 빨라졌지만, 각 페이지 첫 진입 시 그 청크(특히 MaterialDetail + tiptap 569kB)를 그제서야 다운로드 → "느리게 뜸" (lazy의 양날)
  • materials 쿼리: countDueReviewsByMaterialIds가 member_id 조건 없이 flashcard JOIN만 수행 → review_schedule의 (member_id, scheduled_at, status) 인덱스를 못 탐. (prod 실측: 가벼운 API ~0.3s = 네트워크 baseline, materials 추가 ~0.3s가 쿼리 비용)

3. 조치

FE 번들/로딩 (#443)

  • 라우트 React.lazy + Suspense로 분리, vite manualChunks로 tiptap/react/faro 청크 분리
  • QueryClient 기본 staleTime 60s + gcTime 10m + refetchOnWindowFocus: false

FE 체감 속도 (#450)

  • 이미지: 로컬 URL.createObjectURL로 즉시 미리보기 삽입 → 백그라운드 업로드 완료 시 src를 공개 URL로 교체
  • 라우트 prefetch: 로그인 후 requestIdleCallback으로 페이지 청크 미리 로드 (lazy 유지 + 진입 시 캐시 히트)

BE 쿼리 (#453)

  • countDueReviewsByMaterialIds에 r.member_id = :memberId 조건 추가 → 인덱스 활용

4. 결과 (After)

번들 (빌드 산출물):

Before After
초기 진입 단일 1,152 kB index 140kB + react 230kB (tiptap 미로드)
Tiptap 항상 포함 tiptap 569kB — 노트 진입 시에만
  • 이미지: 선택 즉시 미리보기 표시 (업로드는 백그라운드)
  • 페이지: prefetch로 진입 시 이미 캐시 → 즉시 렌더
  • materials: member_id 인덱스 활용 (네트워크 baseline ~0.3s는 인프라 경로로 별개)

5. 교훈 / 후속

  • lazy loading은 양날의 검: 초기 번들은 줄지만 진입 지연이 생긴다. prefetch와 함께 써야 체감이 좋다.
  • 성능 문제는 추측 말고 prod 콜드/웜 반복 측정으로 baseline(네트워크)과 실제 처리 비용을 분리한다.
  • 후속: calendar 645ms는 인덱스는 적절하나 범위 스캔+직렬화 → 데이터 증가 시 Redis 캐싱 검토. 노트 페이지 4개 API는 병렬화 여지.

참고

  • 측정: performance.getEntriesByType('resource'), curl -w %{time_total} 반복

Clone this wiki locally