Next.js 데이터 캐시와 크롬 개발자 도구

상황

나는 page router를 좋아하지만, 이번에는 여러 사정이 있어서 app router를 쓰게 되었다. 이왕 쓰게 된 김에 이런 저런 기능을 몽땅 활용할 생각이었다. 가장 기대하던 기능은 데이터 캐싱이었는데, 가능한 많은 걸 캐싱해두면 랜더링 완료 시점을 한참 일찍 앞당길 수 있을 거란 기대가 있었다.

나는 여러 캐싱 기능을 테스트해보기 위해 아래와 같은 코드를 작성했다. 백엔드에서 랜덤한 기술 질문을 하나 가져오고, ─ 원래라면 revalidate: 10 을 넣었겠지만 ─ 캐시에 TTL 없이 보관하는 설정을 시험해보고자 cache: "force-cache"로 지정해 fetch 요청을 캐싱했다. 이렇게 하면 빌드 시점 이후에는 동일한 요청에 대해 항상 캐시된 데이터를 반환하게 되며, 의도한 대로라면 서버의 부하를 줄이고 클라이언트가 빠르게 응답을 받아 페이지 렌더링도 빨라져야 했다.

  const question = await fetch("http://localhost:3000/api/tech-question", { 
    cache: "force-cache",
  });

  if (question.ok) {
    const data = await question.json()
    console.log(data)
  } else {
    console.log(question.statusText)
  }

문제

아래와 같이 next.config.ts에 logging 설정을 해주면 요청을 보낼 때마다 해당 요청이 캐싱되는지 아닌지 여부를 터미널에서 확인할 수 있다. 그런데 cache hit으로 떠야할 로그가 몇 번을 시도해도 cache skip으로 뜨는 게 아닌가!

const nextConfig: NextConfig = {
  /* config options here */
  logging: {
    fetches: {
      fullUrl: true,
    },
  }
};

cache: "force-cache"를 포함해 다양한 옵션을 테스트해보았지만 cache: "no-store"를 포함해 캐시되지 말아야 할 경우에는 캐시가 되지 않고, 캐시가 되어야 할 경우에도 캐시가 되지 않았다. 그런데 놀랍게도 build 후 start를 하니 캐시가 되어야 할 경우에는 캐싱 되기 시작했다. 그래서 처음에는 단순히 dev 모드에 버그가 있는 게 아닐까 미루어 짐작했다.

하지만 오늘 다른 개발자분이 동일한 node와 next 버전에서 동일한 테스트를 진행했고, dev 모드에서도 문제 없이 캐시가 캐싱되는 걸 확인할 수 있었다. 결국 원인은 다른 데 있는 것이었다.

실마리는 아주 우연히 찾아왔다. 맥을 아예 재시동한 후 dev 모드를 켜자 데이터 캐시가 제대로 작동하기 시작했다. 이상 없이 캐싱되는 것을 확인하고자 크롬 개발자 도구를 열었는데, 그 순간부터 응답 로그에 다시 "cache skip"이 나타났다. 도무지 납득이 되지 않아 여러 번 요청을 반복했지만 결과는 같았다. 개발자 도구가 열려있으면 캐시가 스킵되고, 닫혀있으면 제대로 캐싱되었다. 혹시나 하여 다른 브라우저에서도 테스트해보았지만 개발자 도구가 열려있던 닫혀있던 상관 없이 언제나 캐시가 제대로 캐싱되었다.

내 의심을 확인하기 위해 이전에 테스트에 도움을 주셨던 분께 한 번 더 도움을 요청했다. 하지만 그분은 크롬 개발자 도구를 연 상태에서도 문제 없이 캐싱이 동작한다고 말했다. 그렇다면 '크롬 개발자 도구'가 문제였던 게 아니라 '내 크롬 개발자 도구'에 문제가 있던 것이다. 

해결

react developer tools가 문제일 거라 추측했지만, 원인은 전혀 다른 곳에 있었다. 나는 랜더링 속도를 확인하기 위해 "Disable cache" 옵션을 사용해 응답 결과가 캐싱되는 것을 막아두었는데, 이것이 원인이었다. 해당 옵션을 끄고 다시 테스트해보니, 기대하던 대로 캐시가 정상적으로 작동하기 시작했다.