공통 컴포넌트 제작
피그마 디자인을 기준으로 공통 컴포넌트를 만들고 Storybook 스토리를 함께 작성했다.
- Header: default, explore, menu 3가지 타입 PR
- Input, Textarea: 입력·검색 모드, 초기화 버튼, 최대 길이 제한, 문자 수 표시, 오류 상태 PR
- PhotoGrid: 3열 사진 격자, 날짜 배지, 이미지 로드 실패 시 폴백 PR
- 추후 반응형을 고려해 고정 크기 대신 aspect-ratio로 작성했다.
- Album: 소형·중형 크기, 최대 4장 표시 후 나머지 개수를 오버레이로 표시 PR
트러블슈팅
1. SSR 환경에서 UI 구조를 설계했다
SSR 환경에서 React Client/Server Component를 구분하여 UI 구조를 설계했다. PR Comments
2. HTTP Client 생성을 자동화했다
서버의 API 인터페이스 변경에 유연하도록 HTTP Client 생성을 자동화했다. 이전 프로젝트에서의 경험으로 장단점을 정리하였고, 팀에 도입하기로 결정했다. Post
3. 사진 추가 직후 화면 이동이 먹히는 문제를 해결했다
- 상황: 사진 추가 버튼을 클릭하여 갤러리에서 사진을 선택하고, 정보 기입 화면으로 이동하고자 함 PR
- 문제: 사진 선택 시 화면이 간헐적으로 안 넘어감
- 힌트: 빠르게 사진 추가하면 화면 이동이 잘 안 됨. 천천히 하면 되기도 함
- 가설
- 가설 1) 일시적 메모리 문제: 이건 아니어 보임. 메모리 차지 얼마 안 하기 때문
- 가설 2) 타이밍 문제: 이거일 가능성이 큼. 간헐적으로 발생하는 문제이기 때문
- 가설 3) 클로저 문제
- 가설 2번을 파보기로 함
- 상황: 파일을 선택하면 input.onchange 이벤트가 발생함
- 예상 원인: 파일 선택하고 input 요소를 DOM에 추가하지 않았기 때문에, input.onchange 이벤트가 발생했을 때 브라우저가 안정적으로 input 요소를 찾지 못한 것이다. (빠르게 파일을 선택하면 브라우저가 input 요소를 못 찾는다.)
- 테스트
- AS-IS: input 요소 생성하고 DOM에 추가 안 함
- TO-BE: input 요소 생성하고 DOM에 추가
- 결과
- input 요소를 DOM에 직접 추가하니 간헐적으로 화면 이동이 안 되는 문제가 사라짐
- input 요소를 DOM에 직접 추가하지 않았기에, 브라우저가 input 요소를 간헐적으로 찾지 못했던 것으로 보임
- input 요소에 첨부된 파일 또한 못 찾았기에, 파일이 없으니 화면 이동 로직 또한 작동하지 않았던 것으로 보임
4. RSC 쿠키 갱신 메커니즘을 분석했다
- 문제: RSC에서 호출한 API에 쿠키가 담겨오는데, 이것이 브라우저에 저장되는 것으로 예상했지만 실제 동작은 그러지 않음 Issue
- 원인: 브라우저에서 요청한 HTTP 응답 체인에 RSC에서 요청한 API 응답 쿠키가 포함되지 않음
- Next.js 서버가 이미 HTML을 브라우저에 넘겨준 이후에, RSC 내부에서 API 호출이 일어나고 데이터를 패칭해서 스트리밍으로 데이터가 전달되었음
- 대안: 서버 사이드가 아닌, 브라우저에서 API를 직접 호출하거나,
middleware.ts에서 쿠키 갱신 API를 호출하거나, Route Handler에서 호출하는 방법 - 해결: 브라우저에서 API 직접 호출
- 미들웨어에서 매번 페이지가 렌더링될 때마다 호출하면 불필요한 API 호출을 야기함
5. 사진 업로드 시간을 21초에서 3초로 단축시켰다
- 문제: 사진 1장 업로드에 약 21.9초가 걸렸다. 그중 S3 업로드가 21.3초로 병목이었다. PR
- 원인: 원본 사진(3459KB)을 그대로 S3에 올렸다.
- 해결: 업로드 전에 클라이언트에서 canvas로 사진을 압축했다. 긴 변을 최대 1920px로 줄이고 JPEG로 변환했다.
- 결과
- 파일 크기 3459KB에서 436KB로 감소
- S3 업로드 21.3초에서 3초로 감소
- 전체 업로드 시간 21.9초에서 3.4초로 감소 (-84%)
6. 이미지 포맷을 변경하여 이미지 용량을 3배 감소시켰다
이미지 포맷을 SVG에서 2배수 PNG로 변경할 것을 제안하여, 이미지 용량을 3배 감소시켰다. Comment1 Comment2
7. UI와 상수 이름에 불필요한 도메인 의존성을 제거했다
UI와 상수 이름에 불필요한 도메인 의존성을 제거하여, 변경한 유연한 코드를 고민했다. Commit
- 진입 레벨 상수의 이름이 SHEET_CONTEXT_TYPE였다. 바텀시트에 대한 의존성이 붙어있었다.
- 요구사항이 바뀌어 바텀시트에서 사이드바로 교체되었다.
- 이때 상수의 이름 또한 수정되어야 했다. VIEW_CONTEXT_TYPE으로 수정했다.
- 불필요한 도메인 의존성을 제거하는 것이 변경에 유연한 코드가 되는 방법임을 체감했다.
8. CORS preflight 제거로 로그인 속도를 약 2초 단축시켰다
불필요한 CORS preflight(OPTIONS 요청)를 제거하여, 로그인 속도를 개선했다. PR
- 현상: 카카오 로그인 후 홈 화면까지 이동이 느림
- 운영 환경에서 id/pw 입력 후 로그인 클릭부터 화면 표시까지 6.7초 걸림
- 가장 큰 원인은 서버가 독일에 있다는 것(왕복 1회에 290ms). 그러나 프론트엔드 차원의 해결 방안을 고민
- 로그인 직후 쿠키 API 1건에 1.2초 소요 (preflight 약 0.9초 + 실제 요청 약 0.3초)
- 원인: body가 없는 요청에도 CORS preflight(OPTIONS)가 발생해 왕복이 추가됨
- 모든 API 요청에
Content-Type: application/json가 붙어 있었고, 이 헤더 때문에 cross-origin 요청 전에 preflight가 먼저 나감 - preflight는 쿠키 없이 전송되어, 쿠키를 싣는 요청이 쓰던 기존 커넥션을 재사용하지 못하고 새 커넥션(TCP + TLS)을 맺음
- 기존 커넥션은 credentials: true인 반면, preflight 요청은 credentials: false
- 모든 API 요청에
- 해결: body가 있을 때만
Content-Type붙이기- body 없는 GET·POST가 simple request가 되어 preflight 없이 바로 전송됨
- body가 있는 요청과 PUT·PATCH·DELETE는 기존처럼 preflight 발생
- 결과
- 캐시와 커넥션이 없는 첫 로그인 조건, before 5회 / after 4회를 번갈아 측정, 중앙값
- 시작 시점: 카카오 세션이 유지된 상태에서 “카카오로 계속하기” 클릭
- 쿠키 API가 1.2초에서 0.3초로 감소 (-0.9초, -73%)
- 지도 표시까지 5.8초에서 4.5초로 감소 (-1.3초, -22%)
- 지도 표시: 클릭부터 홈 화면의 지도 canvas가 그려질 때까지
- 홈 API 응답 완료까지 6.7초에서 4.9초로 감소 (-1.8초, -27%)
- 홈 API 응답 완료: 클릭부터 홈 진입 후 호출된 API 6건이 모두 응답할 때까지
- OPTIONS 요청이 7건에서 0건으로 감소
9. Vercel 리전을 변경하여 네트워크 왕복 시간을 줄였다
- 현상: 사진 상세 화면으로 이동하기까지 시간 오래 걸림
- 원인: Vercel 서버가 미국 동부에 위치함
- 해결: Vercel 서버 리전을 서울로 변경
- 결과: 브라우저에서 Vercel 서버까지 왕복 시간 0.2초 → 0.02초
10. Next.js 서버에서 prefetch 시 스트리밍을 적용했다
서버 컴포넌트에서 데이터를 미리 받아올 때, 스트리밍을 적용하여 스켈레톤 노출 시점을 앞당겼다. PR
- 현상: 마이페이지, 계정 정보 관리, 알림 설정, 알림함으로 이동하면 탭 후 화면이 멈춤
- 섹션별 Suspense 스켈레톤이 있는데도 보이지 않고, API 응답 후 한 번에 완성된 화면으로 바뀜
- 원인: page.tsx 맨 위에서 prefetch를 await
- 안쪽 Suspense도 page.tsx가 반환해야 만들어지므로, await이 끝나기 전엔 브라우저로 보낼 수 없음
- 해결: TanStack Query 스트리밍 패턴 공식문서
- await을 제거하고, pending 쿼리도 dehydrate해 진행 중인 요청을 클라이언트로 넘김
- 결과
- 마이페이지, before/after 각 12회 번갈아 측정, 중앙값
- 앱 안 이동
- 처음 보이는 시점 0.44초 → 0.04초 (-0.41초, -92%) (p90 1.02초 → 0.05초)
- 내용 완성 0.44초 → 0.38초 (-0.06초) (p90 1.02초 → 1.04초)
- 주소로 직접 진입
- 서버 첫 응답(TTFB) 0.34초 → 0.02초 (-0.31초)
- 첫 화면 그림(FCP) 0.38초 → 0.12초 (-0.26초, -68%)
- 처음 보이는 시점 0.47초 → 0.15초 (-0.32초)
- 내용 완성 0.48초 → 0.60초 (+0.13초, 늦어짐) (p90 0.73초 → 0.61초)
- API가 느릴 때 (1.5초 지연)
- 처음 보이는 시점 1.53~1.60초 → 0.02~0.08초
- 내용 완성은 변경 전과 동일 (1.51~1.53초)
- 브라우저 중복 요청 0건 (서버가 받은 데이터를 그대로 이어받음)
- 감수할 점
11. preconnect와 HTTP/3로 첫 API 연결 지연을 개선했다
JS 번들을 불러오기 전에 API 연결을 미리 맺고, HTTP/3을 적용하여 첫 API 연결 지연을 개선했다. PR
- 현상: 홈 진입 시 첫 API 응답이 느림
- 페이지 로드부터 첫 API 응답 완료까지 1.25초 걸림 (요청 1건에 약 0.9초)
- 서버가 독일에 있어 왕복 1회에 약 300ms. 연결을 맺은 뒤 요청은 0.3초인데, 새 연결이면 0.6초가 더 걸림
- 웹뷰 앱이라 앱을 열거나 백그라운드에서 돌아올 때마다 새 연결을 맺는 경우가 많음
- 원인: 첫 API 요청 시점에야 TCP + TLS 핸드셰이크를 시작함
- HTTP/2는 TCP 1회 + TLS 1회 = 왕복 2회(약 600ms)를 거친 뒤에야 요청을 보낼 수 있음
- 브라우저는 JS 로딩, hydration 후 첫 fetch가 나갈 때(로컬 측정 기준 약 350ms 시점)까지 API 서버와 연결을 맺지 않음
- 해결
- 프론트: layout
<head>에 API 서버 preconnect 추가<link rel="preconnect" href={API 서버의 origin} crossOrigin="use-credentials" />- API 호출이 credentials: ‘include’라 커넥션 풀을 맞추려면 use-credentials가 필요함 (값이 다르면 미리 맺은 연결을 재사용하지 못함)
- HTML 파싱 시점에 핸드셰이크를 시작해 JS 로딩 시간과 겹치게 함
- 서버: HTTP/3(QUIC) 활성화
- QUIC은 핸드셰이크가 왕복 1회(약 300ms)
- 프론트: layout
- 결과
- 15회씩 측정, 중앙값
- 측정 구간: 페이지 로드부터 홈의 첫 API 요청 응답 완료까지
- preconnect만 적용 시, 1.25초에서 0.93초로 감소 (-0.32초, -26%)
- 20회 중 19회에서 미리 맺은 연결이 재사용됨
- HTTP/3만 적용 시, 1.25초에서 0.96초로 감소 (-0.29초, -24%)
- preconnect와 HTTP/3 둘 다 적용 시, 1.25초에서 0.67초로 감소 (-0.58초, -46%)
- QUIC 핸드셰이크 300ms가 JS 로딩 시간 안에 끝나서, 첫 요청이 이미 열린 연결을 쓰는 것과 같은 속도(왕복 1회, 0.31초)가 됨
12. 목데이터 라이브러리를 프로덕션 번들에서 분리하여 JS 번들 크기를 1MB 줄였다
- 현상: 모든 페이지의 첫 로드 JS가 1.1~1.6MB(gzip)로 과도하게 큼 PR
- 원인: API 코드 생성기(orval)가 API 훅과 목데이터 코드를 한 파일에 생성하여, 트리쉐이킹되지 않은 faker와 msw가 공통 청크에 포함됨
- 해결: 목데이터 코드를 별도 파일로 분리하여 목 모드에서만 동적으로 로드되도록 변경
- 결과: 페이지별 첫 로드 JS 약 1MB(gzip) 감소 (홈 1.59MB → 0.56MB, 마이페이지 1.18MB → 0.15MB)
- 최신 아이폰 기준 로드 시간 약 1초 단축 예상 (다운로드 0.2초 + 파싱 및 실행 0.8초)
배운 점
1. 대립된 의견으로 프로덕트의 본질을 고민했다
우선순위 설정에 의견 차이가 있었다. 바텀시트에서 사이드바로 UX 개선하는 건이었다. 나는 그것이 핵심 가치에 크게 영향주지 못할 거라 생각했다. 따라서 우선순위가 낮다고 생각했다. 앱 출시 이후로 밀고 싶었다. 그러나 PM님과 디자이너님은 그것이 우선순위가 높다고 생각하셨다. 이유는 크게 두 가지였다.
- MVP가 아닌 MLP(Minimum Lovable Product)를 만들어야 한다는 것
- 사용자가 바텀시트를 접하고 사이드바로 바뀌면 불편함을 느낄 거란 우려
1번에 있어서 공감하는 바였다. 그러나 나는 기존 바텀시트 UX도 핵심 가치를 경험하기에 크게 불편함이 없다고 생각했다. 왜냐면 이미 두 차례 UT를 거치며 플로우 성공율이 높아졌고(평균 75% → 95%, 표본 12명), 데모데이 때 사용하는 걸 본 결과 사용자가 핵심 기능을 사용하는 데까지 큰 허들이 없었다는 걸 관찰했기 때문이었다. 발견으로 알 수 있는 귀납적 가설이었기 때문에, 연역적으로 실험하기 전까진 의문 해소가 어려운 부분이었다. 따라서 그 실험을 앱 출시 이후 UX 개선 건으로 해도 된다는 의견이었다. (물론 디자이너님께서 더 나은 UX를 고민한 결과 사이드바를 고안해주신 부분은 존경할 만한 일이었다.)
2번에 있어서 단기적인 불편함이라고 보았다. 장기적인 관점에서 시간 지나면 학습해서 익숙해지기 때문에 크리티컬한 문제는 아니라고 보았다. 통계적 관점에선 평균회귀, 프로덕트 관점에선 Carrying Capacity 개념과 비슷하다고 생각했다. 단기적으로 잠깐 불편하더라도 시간 지나면 프로덕트의 기본 체력이 드러날 것이며, 기다릴 필요가 있는 시간 문제라고 생각했다.
따라서 내 의견은 바텀시트 버전을 우선 출시하고 나중에 UX 개선 건으로 사이드바로 변경해도 늦지 않다는 생각이었다.
하지만 나는 실제 고객이 아니라 메이커 입장이다. 따라서 내 생각이 틀릴 수도 있었다. 또한 기획과 일정 산정에 있어서 최종 결정권자는 PM님이셨다. 위의 의견은 나의 제안일 뿐이었다. 결과적으로 회의 시간에 PM님을 충분히 설득하지 못했다. PM님께서 결정을 내린 이상 나는 믿고 책임을 다하면 된다고 생각했다.
그러나 찜찜함이 남았다. 충분히 납득이 가지 않은 상황에서, 좀 더 문을 두드려보기로 했다. 새벽에 1시간 동안 대화를 나눠서 PM님을 설득하는 데 성공했다. 이후 디자이너님이 들어오시고 2시간 동안 대화를 나눠서 내가 설득당했다. 결론적으로 사이드 바 개선 건을 Phase 3가 아닌 Phase 2에 하기로 결정했다. 해당 개선 건이 핵심 가치에 얼마나 직접적인가, 크리티컬한가를 보았다. 내가 보지 못한 부분을 디자이너님께선 보고 계셨다. 크리티컬하다고 생각하고 계셨던 것이었다. 결정하려면 직관이 필요해 보였다. 앞으로 무언가 일을 한다면 본질을 고민하는 것이 필요해 보였다.
대화를 나누고 나 스스로 의문이 있었던 부분(사이드바 개선하는 게 핵심가치에 직접적인가?)이 상당 부분 해소되었다. 그래서 다행이었다.
사실 내가 납득당한 데는 대화를 하며 디자이너님에 대한 믿음이 생겨서였다. 디자인과 인간 심리라는 책을 추천해주시며 휴리스틱, 직관의 중요성을 말씀해주셨는데 그 내용에 공감하면서도 그 내용 자체로 근거가 된 건 아니었다. 이 사람이 책을 찾아보면서 공부를 하고 그걸 프로젝트에 반영하면서 발전하는 사람이구나라는 걸 느껴서 그렇다. 이 사람이라면 내가 보지 못한 중요한 걸 볼 수도 있겠구나 싶었기에 사람 자체에 대한 믿음이었다. 성장을 위해 노력한 경험이 있기에 생기는 거라고 생각했다.
2. 개발부터 인터뷰까지 경험했다
개발 전, 사진을 주제로 3명과 인터뷰했다. PM님께서 서비스 핵심적인 질문에 답변을 안 주셔서 상황이 제대로 안 굴러간다고 느꼈다. 3번 여쭤봤는데 답을 안 주셨다. 그래서 직접 나서야겠다 생각했다. 카톡으로 연락해서 회의를 잡았다. 내가 가진 고민을 털어놓고 방향성을 제안했다. 고객 입장에서 생각하기 위해 인터뷰해야 되겠다는 결론에 도달했다. 새벽에 3시간 동안 PM님과 함께 문제가설을 세웠다. 그 다음날 PM님이랑 내가 각자 인터뷰해와서 문제가설 검증했다. 인터뷰한 3명 중 1명이 문제를 겪고 있음을 확인했다. 그래서 PM님도 그렇고 나도 스스로 어느 정도 납득된 상태에서 일을 진행할 수 있었다. 인터뷰로 인사이트를 얻은 결과, 타겟층을 커플로 좁혔다.
개발 후, 3명의 커플을 대상으로 인터뷰를 진행했다. The Mom Test 인터뷰 방법론을 정리해 팀에 공유했다. 새벽에 팀원과 인터뷰를 실습했다. 실제 인터뷰 할 때, 과거에 문제 해결을 위한 행동을 실제 행했는가를 파악하여 니즈의 강도를 판단했다. 어떤 질문이 좋은 질문인가에 대해 팀원과 고민했다. 예를 들어 “앞으로도 해당 서비스를 이용할 것 같나요?”라는 질문에 대해, 직접적으로 과거의 행동을 묻는 질문이 아니라서 별로 도움이 되지 않을 거라 예상했지만, 후속 질문에서 중요한 인사이트를 뽑아낼 수 있는 마중물 역할을 할 수도 있다는 걸 알게 되었다. 인터뷰 결과, 사용자의 행동을 촉진하는 트리거로 알림 기능이 로킷 앱에서 중요한 역할을 할 거라는 인사이트를 얻었다. 따라서 앱에 알림 기능을 추가했다.
3. 온보딩 퍼널을 개선했다
모수가 2명이진 하지만 사용자 행동 추적 툴인 Mixpanel에서 개별 사용자 여정을 조회했다. 로그 태깅해놓고 배포한 다음, 로그인부터 온보딩 과정(프로필 설정(사진 업로드, 이름 입력), 파트너 연결)을 겪어 홈까지 연결되는 퍼널 보고서를 만들어서 봤다. 그 결과 실사용자 두 명이 각각 프로필 설정과 파트너 연결에 갇혀서 홈까지 도달하지 못했단 것을 발견했다. 회의에서 논의사항으로 제시하였고, 디자이너님의 의견을 얻어 다음 스프린트에 온보딩 퍼널을 개선하기로 결정했다. 핵심 가치를 조금 더 빠르게 느낄 수 있도록 로그인부터 홈까지의 거리를 좁혔다.
- Before: 로그인 → 프로필 설정 → 파트너 연결 → 홈
- After: 로그인 → 홈 (→ 프로필 설정, 파트너 연결)