빌드 시간이 길어질 때 확인해야 할 로그

Next.js 프로젝트의 빌드 시간이 갑자기 늘어났다면, 혼자만의 감으로 접근하면 안 된다. 확인한 값과 바꾼 값을 따로 남기는 습관이 필요하다.

웹 렌더링 상태 확인

빌드 시간이 길어지는 원인은 보통 sitemap 생성, RSS 피드, 메타데이터 처리 등에서 나온다. 환경 차이를 고려해서 원인을 좁혀야 한다.

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

메타데이터 검증

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

공개 URL에서 메타데이터와 canonical 태그가 올바르게 설정되어 있는지 확인한다. 빌드 로그에서도 경고나 오류가 없는지 봐야 한다.

정상 상태 정의

웹 렌더링 작업은 로컬과 운영의 차이가 자주 숨어 있다. 빌드 로그에서 경고 없이 완료되고 메타데이터가 정확한 상태를 정상으로 정의해두자.

최종 확인

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

마지막에는 실제 화면이나 공개 URL까지 확인해야 작업이 끝난다. 작은 기록을 남겨두면 다음 확인이 훨씬 빨라진다.