아직 Next.js 13 으로 정적 사이트를 만들지 마세요

Next.js v13.4.4

요약

• App router 방식의 static export 에 치명적인 버그가 있습니다. 공식 문서에는 버그에 대한 내용이 설명되어 있지 않습니다.
• 이 방식이 가능한 Next.js 이전 버전이 없습니다.
• 따라서 정적 사이트를 만들기 위해서 App router 대신 Page router 방식을 이용하세요.

개요

정확히는 아직 App router 방식으로 정적 사이트를 만들어서는 안됩니다. 그 이유는 간단한데 아직 이 방식으로 정적 사이트를 배포할 수 없습니다.

문제

• generateStaticParams 는 동적 라우팅 페이지에 대해 빌드타임에 프리 렌더해야 하지만 실제로는 생성되지 않습니다.

가장 큰 문제는 현재 Next.js 공식문서에는 아무런 버그가 없다는 듯이 작성되어 있다는 것입니다. 많은 개발자들이 혼동을 겪고 있습니다.

공식문서 설명

• static route
• generateStaticParams

관련이슈

• https://github.com/vercel/next.js/issues/48022
• https://github.com/vercel/next.js/issues/48996

아래처럼 v13.2 로 다운그레이드 이후 잘 돌아간다는 의견이 있지만, App router 에 대한 static export 는 v13.3 이후에 지원하기 시작했으니 아래와 같은 명령을 따르지 마세요.

해결

• 정적 사이트를 만들기 위해서 App router 대신 Page router 방식을 이용하세요.