Repository navigation
ELOG 005 perf codesplit prefetch query
wcorn edited this page Jun 6, 2026
·
1 revision
| 항목 | 내용 |
|---|---|
| 분류 | ⚡ 성능 개선 |
| 날짜 | 2026-06 |
| 영역 | FE (Vite/React/Tiptap) / BE (JPA) |
| 관련 이슈/PR | #443, #450, #453 |
| 상태 | 해결 (일부 모니터링) |
인덱스로 돌아가기: Engineering Log
"뭔가 느리다"는 피드백. 구체화하니 세 가지였다.
- 초기 번들이 큼 — 빌드 시 단일 청크 1,152 kB ("chunks larger than 500kB" 경고)
- 이미지 업로드 시 업로드 완료 후에야 이미지가 보임 (2.4MB면 수 초 빈 화면)
- 페이지 접근 시 컴포넌트가 늦게 뜸
- (실측)
GET /api/planner/materials가 데이터가 거의 없는데 웜에서도 ~0.6초
-
번들: 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가 쿼리 비용)
FE 번들/로딩 (#443)
- 라우트
React.lazy+Suspense로 분리, vitemanualChunks로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조건 추가 → 인덱스 활용
번들 (빌드 산출물):
| Before | After | |
|---|---|---|
| 초기 진입 | 단일 1,152 kB | index 140kB + react 230kB (tiptap 미로드) |
| Tiptap | 항상 포함 |
tiptap 569kB — 노트 진입 시에만 |
- 이미지: 선택 즉시 미리보기 표시 (업로드는 백그라운드)
- 페이지: prefetch로 진입 시 이미 캐시 → 즉시 렌더
- materials: member_id 인덱스 활용 (네트워크 baseline ~0.3s는 인프라 경로로 별개)
- lazy loading은 양날의 검: 초기 번들은 줄지만 진입 지연이 생긴다. prefetch와 함께 써야 체감이 좋다.
- 성능 문제는 추측 말고 prod 콜드/웜 반복 측정으로 baseline(네트워크)과 실제 처리 비용을 분리한다.
- 후속: calendar 645ms는 인덱스는 적절하나 범위 스캔+직렬화 → 데이터 증가 시 Redis 캐싱 검토. 노트 페이지 4개 API는 병렬화 여지.
- 측정:
performance.getEntriesByType('resource'),curl -w %{time_total}반복