🛠️ 프로젝트 맥락

• 팀 구성: 프론트엔드 + DB 개발자로 구성된 팀
• 서버 구조: Next.js Server Actions + SQL 프로시저
• 마이그레이션 배경: Next.js 15의 Server Actions 안정화 및 React 19 도입 대응

⚠️ 주요 이슈: searchParams 비동기화로 인한 무한 렌더링

상황

• Next.js 15에서 searchParams가 비동기 방식으로 변경됨
• 기존 날짜 필터 컴포넌트에서 searchParams를 props로 받아 초기값을 설정
• 해당 시점에 props 값이 undefined → 렌더링 후 값 업데이트 → 상태 변경 → 렌더링 반복

부가 문제

• 해당 컴포넌트에 스크롤 탑 로직(scrollTo(0, 0))이 포함되어 있어

  → 무한 렌더링 중 계속 스크롤이 맨 위로 튕김

  → UX 및 디버깅에 큰 불편 발생

✅ 해결 방법

1. searchParams 초기값 처리 방식 변경
   • useSearchParams()로 컴포넌트 내부에서 직접 조회
   • useEffect를 활용해 값이 안정적으로 resolve된 이후 상태 초기화
2. props 기반 데이터 전달 제거
   • 상위에서 props로 넘기던 구조 제거
   • searchParams는 각 컴포넌트에서 직접 처리
3. 스크롤 로직 조건 처리
   • searchParams 변화가 실제 의미 있는 변화일 때만 스크롤 이동 실행
4. 팀 가이드 정비
   • searchParams 사용 시 비동기 처리 방식 고려한 가이드 작성 및 공유

🧠 회고