Next.js 배포 후 캐시 문제를 푸는 기준

Next.js 배포 후에 캐시가 제대로 작동하지 않을 때는 보통 어디서부터 시작해야 할지 불명확하다. 중요한 건 웹 렌더링 전체 흐름을 따라가면서 한 단계씩 확인하는 것이다.

핵심 질문부터 던지기

중요한 건 Next.js 문제 자체보다 재현 가능한 단서를 남기는 것이다. Canonical을 확인하면 다음으로 봐야 할 범위가 줄어난다.

먼저 제외할 원인 찾기

Next.js 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 한다.

• 먼저 볼 값: sitemap/RSS
• 비교할 값: 정상 상태의 웹 렌더링
• 남겨둘 기록: 명령 출력, 응답 코드, 수정한 설정

Canonical과 확인 순서

정상 상태를 먼저 정해두는 게 좋다. 그래야 빌드 로그가 맞는지 빠르게 판단할 수 있다.

curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'
npm run build

예상되는 정상 상태 파악하기

웹 렌더링은 한 단계씩 확인해야 한다. 공개 URL이 애매하면 다른 부분을 고쳐도 결과가 바뀌지 않을 수 있다.

빌드 로그를 해석하는 법

Next.js 문제는 화면만 보고 판단하면 놓치는 값이 많다. 로그, 응답, 설정 중 하나를 증거로 잡아야 다음을 진행할 수 있다.

최종 검증

1. 원래 증상이 같은 조건에서 다시 나는지 확인한다.
2. 로그나 응답에서 바뀐 부분을 한 줄로 설명해본다.
3. 공개 화면, 빌드 결과, 실제 요청 중 하나로 마지막 확인을 한다.

마무리

웹 렌더링은 로컬과 운영의 차이가 자주 숨어 있다. 환경 차이까지 적어두면 원인 추적이 쉬워진다. 마지막에는 실제 화면이나 공개 URL까지 확인해야 작업이 끝난다.