화면에 필요한 장바구니 아이템 개수(itemCount)와 합계 금액(totalPrice)을 items 배열과는 별개로 각각 독립된 상태(state)로 만들어 두었었다. items가 바뀔 때마다 setItemCount와 setTotalPrice를 같이 호출해서 동기화하는 방식이었다. 매번 렌더링할 때마다 다시 계산하지 않아도 되니 성능적으로 당연히 이득이라고 생각했다.
쿠폰 로직 추가와 예상치 못한 오동작
얼마 전 할인 쿠폰을 적용하는 로직을 추가하게 되었다. 이 과정에서 장바구니의 items를 갱신하는 새로운 경로가 하나 더 추가되었다. 바쁘게 코드를 작성하다 보니, 새로 추가된 경로에서 그만 setTotalPrice를 호출하는 것을 누락하고 말았다.
화면에는 장바구니 목록이 완벽하게 정상 노출되었지만 합계 금액만 예전 값 그대로 유지되는 버그가 발생했다. 콘솔창에 경고 한 줄 없었고 타입 에러조차 잡히지 않았다. 값이 그저 오동작하는, 추적하기 매우 까다로운 현상이었다.
반나절의 디버깅과 동기화의 함정
원인을 규명하는 과정에만 무려 반나절 이상이 소요되었다. 에러 로그가 전혀 남지 않아 프로젝트 전체에서 items 배열을 수정하는 모든 함수들을 일일이 뒤져야 했다. 각 함수 경로마다 totalPrice도 세트로 갱신해주었는지 수동으로 확인하는 것 외엔 뾰족한 방법이 없었다.
이러한 상태관리 안티패턴에 빠지게 되니 데이터의 동기화를 놓칠 위험이 계속해서 누적되었다. 상태가 불필요하게 쪼개질수록, 그리고 상태를 조작하는 인터페이스가 사방에 흩어질수록 사이드 이펙트는 걷잡을 수 없이 커졌다.
상태를 지우고 파생값으로 전환하기
더는 안 되겠다 싶어 결국 기존의 독립된 itemCount와 totalPrice 상태를 전부 지워버렸다. 대신 items 상태에 기반하여 매 렌더링 시점에 값을 동적으로 유도하는 파생값 구조를 선택하고 useMemo를 도입했다.
- 불필요한 중복 상태 제거로 동기화 누락 원천 해결
- useMemo를 활용한 안정적인 일관성 유지
- 상태 수정 경로 단순화로 인한 코드 품질 향상
수정 후에는 동기화 자체가 구조적으로 보장되면서 골치 아픈 데이터 왜곡 버그가 다시는 재발하지 않게 되었다. 이번 경험 이후로 프론트엔드 실무에서 어설픈 최적화에 목매는 대신 진짜 상태와 파생값의 영역을 구분해내는 직관이 확실하게 달라졌다.
이러한 현업 중심의 실무 노하우와 올바른 설계 원칙들을 깊이 있게 체계화하다 보니, 자연스럽게 《프론트엔드 실무 디테일》이라는 책 한 권으로 정리하게 되었다.
어떤 설계를 지향해야 실수를 방지하고 더 견고한 코드를 만들 수 있을지 궁금하다면, 핵심 체크리스트를 투명하게 담아낸 무료 미니북을 먼저 가볍게 읽어보는 것을 추천한다.
그 이상의 탄탄한 개념과 실전 응용 디테일을 더 보고 싶다면 전자책 본편을 확인하면 된다.
이런 노하우들이 어떤 프로젝트를 거치며 쌓인 건지 궁금하다면, 그동안 지나온 프로젝트와 이력을 정리해둔 나의 포트폴리오를 한 번 봐도 좋다.