헷갈리기 쉬운 상황
Server Component waterfall: 정상처럼 보이는 한 사례만으로는 동작 범위를 이해하기 어렵습니다. 대표 입력에서는 문제없다가 경계값, 느린 응답, 배포 직후처럼 조건이 달라질 때 결과가 바뀔 수 있습니다.
서로 독립인 server data fetch를 부모 결과 뒤에 순차 배치하면 network·DB 대기가 직렬화되므로 dependency가 없는 작업은 일찍 시작해야 합니다.
핵심 원리
React Server Component, route, 데이터 캐시와 브라우저 라우터가 함께 동작하는 Next.js App Router에서 어느 경계가 결과를 결정하는지 먼저 봅니다. render에서 계산할 값, 사용자가 소유한 state와 외부 시스템 동기화를 구분합니다. update를 시작한 값과 다시 update된 dependency를 따라가면 순환 원인을 찾을 수 있습니다.
| 구분 | 짧은 예시 |
|---|---|
| 기대 결과 | Server Component waterfall: 정상 조건에서 사용자가 받아야 할 결과 |
| 실제 결과 | 같은 입력에서 처음 달라진 값·상태·오류 |
| 판별 자료 | 빌드 route 분류, 서버 로그, 응답 Cache-Control, RSC 요청과 데이터 쿼리 수를 구분해 본다 |
실무에서 확인할 것
Server와 Client 경계를 좁히고 데이터 변경 계약에 맞춰 캐시 태그, 재검증과 동적 렌더링을 명시한다. 파생값은 가능한 한 render나 computed에서 계산하고 effect·watch는 외부 동기화에만 둡니다. 비동기 작업은 최신 요청 식별자나 취소 신호와 cleanup을 갖게 합니다.
대표 사례 하나, 값이 달라지는 경계 하나, 예상 가능한 실패 하나를 같은 순서로 확인합니다. 프로덕션 빌드에서 정적·동적 route, 번들 크기, TTFB, 캐시 적중과 관리자 변경 직후 일관성을 확인한다. 초기 render, 연속 입력, 느린 응답의 순서 역전, unmount와 SSR hydration에서 state·DOM·cleanup이 기대한 순서로 바뀌는지 확인합니다.
공식 문서와 적용 범위
문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 runtime·framework version, 실제 입력과 요청 흐름에서 다시 확인합니다.