Next.js
Next.js 빌드 로그를 다룰 때
Next.js 배포 전에는 빌드 로그가 핵심이다. 검색으로 찾은 해결책도 바로 적용하기 전에 현재 빌드 상태를 먼저 파악하는 게 빠르다.
Next.js 프로젝트에서 배포 전에 빌드 로그에 경고가 많으면 불안하다. 특히 검색에서 찾은 코드를 적용했을 때 빌드는 성공하는데 실제 페이지에서 문제가 나면 추적하기 어렵다.
웹 렌더링 전체 흐름에서 원인을 좁혀가는 게 중요하다. 한 부분만 보면 놓치는 게 많다.
빌드부터 확인하자
metadata 설정을 수정했다면 먼저 빌드가 완료되는지 확인해야 한다. 빌드에서 실패하면 런타임에서 아무리 확인해도 소용없다.
- Canonical 태그
- 정상일 때의 렌더링 상태
- 기록할 사항: 명령어 출력, 상태 코드, 설정 변경사항
서버에서의 응답 확인
빌드 후 실제 HTML 응답을 확인해보자. 메타데이터가 제대로 포함되지 않으면 SEO 문제가 생긴다.
curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'
npm run build
최종 확인 단계
- 같은 조건에서 빌드 에러가 반복되는지 확인
- 로그와 응답에서 변화를 정리
- 공개 환경에서 최종 테스트
해결 자체보다 어떤 값이 달라졌는지 설명할 수 있는 상태가 더 중요하다.