본문 바로가기
seungchan.dev
뒤로

CSR 앱에 ISR을 도입하며 SWR로 hydrate를 직접 구현한 기록

CSR로만 돌던 App Router 웹뷰 앱에 ISR을 도입하면서, React Query의 hydrate 대신 SWR fallback과 unstable_serialize로 서버 데이터를 클라이언트에 넘긴 과정을 정리했습니다.

7분 읽기#실무 회고#Next.js

SSR을 붙이려는 순간 "서버 컴포넌트에서는 훅을 호출할 수 없다"는 오류를 만났습니다. 저희 데이터 요청은 전부 SWR 훅이었습니다.

CSR로만 구성된 프로젝트에 ISR(Incremental Static Regeneration)을 도입하면서, 데이터를 서버에서 클라이언트로 넘기는 방법도 다시 정해야 했습니다. React Query로 갈아타는 대신 React Query의 hydrate 방식을 참고해, SWR의 fallback으로 같은 흐름을 직접 만들었습니다.

CSR 웹뷰 앱의 초기 로딩, 그리고 서버에서 쓸 수 없는 SWR 훅

CSR로만 렌더링하던 하이브리드 앱에 ISR + SSR(Server-Side Rendering)을 도입하려 했는데, 데이터 요청이 모두 서버 컴포넌트에서 쓸 수 없는 SWR 훅이었습니다.

ISR 자체는 다른 분이 잘 정리한 글로 대신합니다. https://medium.com/@zero86/next-js-csr-ssr-isr-ssg-%ED%95%98%EC%9D%B4%EB%B8%8C%EB%A6%AC%EB%93%9C-hybrid-%EB%A0%8C%EB%8D%94%EB%A7%81-%ED%95%98%EC%9D%B4%EB%93%9C%EB%A0%88%EC%9D%B4%EC%85%98-hydration-e2f6a487fe95

CSR만 쓰던 구조

저희는 CSR 웹뷰로 하이브리드 앱을 제공하고 있었습니다. 페이지마다 use client 디렉티브를 붙여, 페이지가 로드되면 모든 콘텐츠를 클라이언트에서 동적으로 렌더링했습니다. 데이터를 요청한 뒤 클라이언트에서 처리하는 구조라 초기 로딩이 상대적으로 느릴 수 있었습니다.

서버 컴포넌트에서는 SWR 훅을 쓸 수 없다

Next.js의 SSR 방식을 도입하려 하자, 서버 컴포넌트에서 hook을 호출할 수 없다는 오류가 났습니다. "그러면 SWR로 데이터 호출을 할 수 없잖아..?" 이때부터 불안해져서 구글 검색과 문서를 미친 듯이 봤습니다.

공식 문서에는 Pages Router에서의 사용법만 나와 있었습니다. 저희는 App Router를 쓰고 있어서 그대로 적용할 수 없었습니다.

팀을 설득해야 했다

"좋은 건 알겠어, 근데 꼭 적용해야 해?" 렌더링 방식을 바꾸기 전 팀원들에게 가장 많이 들은 질문입니다. SSR + ISR 도입은 간단한 결정이 아니었고, 팀원을 설득하려면 저부터 이유가 분명해야 했습니다.

CSR 유지냐 ISR이냐, React Query로 옮기냐 SWR로 만드냐

CSR 유지 vs SSR + ISR 도입

제가 정리한 도입 이유는 이렇습니다.

  • 빠른 초기 로딩과 효율적인 성능 관리: ISR은 빌드 시점에 서버에서 HTML을 미리 렌더링해 전달하므로, 페이지가 처음 로드될 때 빠르게 콘텐츠를 보여 줄 수 있습니다. 웹앱 초기 로딩에서 생기는 지연을 크게 줄일 수 있습니다.
  • 필요한 페이지만 다시 생성: 페이지를 정적으로 생성하되, 필요할 때 백그라운드에서 자동으로 새로 만듭니다. 처음 로드된 페이지는 정적으로 제공되고, 변경이 생길 때만 새 페이지를 생성하므로 서버 부담을 줄이면서 성능을 유지할 수 있습니다. 모든 페이지가 아니라 필요한 페이지만 갱신됩니다.

설득할 때 가장 강조한 것은 최종 사용자에게 미치는 영향과 개발·유지보수의 효율이었습니다.

  • 더 빠른 페이지 로딩: 초기 로딩을 빠르게 해 첫 화면을 볼 때의 지연을 줄입니다. 사용자 경험이 좋아지고 이탈률 감소로 이어질 수 있습니다.
  • 효율적인 데이터 처리: 서버 자원을 효율적으로 쓰면서도 실시간 데이터를 반영할 수 있어, 성능과 확장성 면에서 장점이 큽니다.

React Query의 hydrate: 서버 데이터를 넘기는 기성품

다른 분들의 구현을 찾아보다가 React Query의 "hydrate" 방식을 발견했습니다. hydrate는 SSR과 클라이언트 사이에서 데이터를 이어 줍니다. 서버에서 가져온 데이터를 클라이언트로 넘기고, 클라이언트는 그 데이터를 다시 요청하지 않고 재사용합니다.

먼저 서버에서 React Query로 필요한 데이터를 미리 가져온 뒤, dehydrate 메서드로 직렬화(serialize)해 JSON 형태로 클라이언트에 전달합니다.

js
// 서버 측 예시
import { dehydrate, QueryClient } from '@tanstack/react-query';
 
export async function getServerSideProps() {
  const queryClient = new QueryClient();
 
  await queryClient.prefetchQuery(['key', params], fetchData);
 
  return {
    props: {
      dehydratedState: dehydrate(queryClient),
    },
  };
}

클라이언트는 받은 데이터를 hydrate로 복구(deserialize)합니다. 같은 데이터를 다시 요청하지 않고 서버가 넘긴 데이터를 그대로 씁니다.

jsx
// 클라이언트 측 예시
import { Hydrate, QueryClient, QueryClientProvider } from '@tanstack/react-query';
 
function MyApp({ Component, pageProps }) {
  const queryClient = new QueryClient();
 
  return (
    <QueryClientProvider client={queryClient}>
      <Hydrate state={pageProps.dehydratedState}>
        <Component {...pageProps} />
      </Hydrate>
    </QueryClientProvider>
  );
}

SWR에는 hydrate가 없었다

"오...? 이런 기능을 제공하는구나..?" 하며 SWR 문서를 뒤지기 시작했습니다. 같은 회사에서 만든 거니까 당연히 있겠지 했는데, 제 생각과 달리 SWR은 hydrate 같은 기능을 제공하지 않았습니다.

선택지얻는 것잃는 것
React Query로 전환hydrate를 기성 기능으로 바로 사용기존 SWR 데이터 요청을 모두 옮겨야 함
SWR로 hydrate 흐름 직접 구현기존 코드 유지, 동작 원리를 깊게 이해직접 만들고 검증하는 비용

"React Query로 넘어가야 하나.." 마음이 90%쯤 기울었습니다. 그래도 제공되는 기능을 흉내 내 직접 만들어 보면 더 깊게 이해할 수 있겠다는 믿음으로, SWR로 hydrate 기능을 구현하기로 했습니다.

SWR fallback과 revalidate로 페이지를 ISR로 바꾸다

목록 페이지: 서버에서 받은 첫 페이지를 fallback으로 넘긴다

기존 코드입니다. use client로 클라이언트에서만 데이터를 가져와 렌더링합니다.

jsx
'use client';
 
...
 
const Page = () => {
  const { datas, error, isLoadingMore } = useInfiniteScroll(
    fetchOrderListByPartner,
    10,
    1000,
    'careList',
  );
 
  if (datas.length === 0) {
    <section className='pt-[70px]'>
      <NoDataFoundForm contents={['간병목록이', '없습니다.']} />
    </section>;
  }
 
  return (
    <article
      className={`${datas && datas.length >= 1 ? 'bg-Neutral-White' : ''} h-full pt-[48px]`}
    >
      <section>
        <section className='Title05 bg-Neutral-White flex flex-col space-y-[6px] pb-4 pl-4 pr-4 pt-[30px]'>
          <span>환자님들이</span>
          <span>케어매니저님을</span>
          <span>기다리고 있어요!</span>
        </section>
        <section className='bg-Neutral-White h-full'>
          {datas && datas.length >= 1 && (
            <div className='bg-Neutral-White pb-[80px]'>
              {datas.map((care) => {
                return (
                  <div key={care.order_id} className='bg-Neutral-White pl-4 pr-4 pb-4'>
                    {<PartnerJobPreviewForm care={care} />}
                  </div>
                );
              })}
            </div>
          )}
        </section>
      </section>
      {isLoadingMore && <SkeletonWorkSearch />}
    </article>
  );
};
 
export default Page;

개선한 코드입니다.

jsx
export const revalidate = 60;
 
import { fetchOrderListByPartner } from '@/service/server/orders';
import { unstable_serialize as infinite_unstable_serialize } from 'swr/infinite';
import WorkSearchList from './_components/work-search-list';
import SwrProvider from '@/app/_provider/swr_provider';
 
const Page = async () => {
  const orderList = await fetchOrderListByPartner();
  const key = 'careList';
  const pageSize = 10;
  const fallbackKey = infinite_unstable_serialize(
    (index) => `${key}-${index * pageSize}`,
  );
 
  return (
    <article className={`bg-Neutral-White w-full h-full pt-[48px]`}>
      <section className='h-full bg-Neutral-White'>
        <section className='w-full h-full'>
          <SwrProvider fallbackKey={fallbackKey} fallbackData={[orderList]}>
            <WorkSearchList />
          </SwrProvider>
        </section>
      </section>
    </article>
  );
};
 
export default Page;

ISR로 60초마다 페이지를 재검증하고, ISR과 SWR을 조합했습니다.

  • SwrProvider에 fallbackData 설정: 서버에서 데이터를 미리 받아 와 초기 화면을 빠르게 그립니다. SWR이 이 초기 데이터로 UI를 바로 렌더링하고, 이후에는 백그라운드에서 데이터를 갱신합니다.
  • infinite_unstable_serialize: 무한 스크롤을 효율적으로 구현합니다. 페이지 번호를 동적으로 계산해 필요한 데이터를 점진적으로 가져옵니다.

동적 경로 페이지: generateStaticParams로 미리 만든다

목록만이 아니라 상세 페이지 같은 동적 경로도 바꿨습니다. 기존 코드도 목록 페이지처럼 use client로 CSR만 적용돼 있었습니다.

jsx
'use client';
 
import { SlideRightArticle } from '@/components/animation';
import BackHeader from '@/components/back-header';
import CareDetailForm from '@/components/care/care-detail-form';
import { useRouter } from 'next/navigation';
 
const Page = () => {
  const router = useRouter();
  return (
    <article className='h-full'>
      <section className='fixed w-full bg-white z-40'>
        <section className='pl-4 pr-4'>
          <BackHeader
            title='간병 상세정보'
            prePathFn={() => {
              router.push('/partner/my-care');
            }}
          />
        </section>
      </section>
 
      <SlideRightArticle key={''} className={'pt-[2.25rem]'}>
        <CareDetailForm />
      </SlideRightArticle>
    </article>
  );
};
 
export default Page;

개선한 코드입니다.

tsx
export const revalidate = 60;
export const dynamicParams = true;
import { SlideRightArticle } from '@/components/animation';
import BackHeader from '@/components/back-header';
import CareDetailForm from '@/components/care/care-detail-form';
import { fetchOrderListByPartner } from '@/service/server/orders';
 
export const generateStaticParams = async () => {
  const managerList = await fetchOrderListByPartner();
 
  return managerList.map((manager) => ({
    id: manager.id.toString(),
  }));
};
 
const Page = async ({ params }: { params: { id: string } }) => {
  const { id } = params;
 
  return (
    <article className='h-full'>
      <section className='fixed w-full bg-white z-40'>
        <section className='pl-4 pr-4'>
          <BackHeader title='간병 상세정보' />
        </section>
      </section>
      <SlideRightArticle key={'care-detail'} className={'pt-[2.25rem]'}>
        <CareDetailForm orderId={id} />
      </SlideRightArticle>
    </article>
  );
};
 
export default Page;

빌드 시점에 페이지를 정적으로 렌더링하고, 이후에는 revalidate = 60 주기로 다시 생성합니다.

초기 로딩은 빨라졌고, 상태 관리의 경계가 보였다

ISR을 적용한 페이지는 서버가 미리 만든 HTML과 fallback 데이터로 첫 화면을 그립니다. 초기 로딩이 크게 빨라지고 서버 부하도 줄었으며, 동적 경로에도 정적 파일을 제공하므로 SEO에도 유리해졌습니다.

배운 것

CSR에서는 렌더링과 데이터 패칭이 모두 클라이언트에서 일어나서 초기 렌더링이 느릴 수 있고, 데이터 상태도 클라이언트에서만 관리됐습니다. ISR은 서버에서 미리 만들고 필요한 시점에만 갱신합니다.

그 렌더링 시점의 차이를 따라가다 보니 서버 상태와 클라이언트 상태를 어디서 나눌지 명확히 정할 수 있었고, 데이터 일관성과 성능, 사용자 경험을 어떻게 맞출지 더 깊게 고민하게 됐습니다.