구성요소 · 검토 중

Next.js 빌드 산출물

Next.js 빌드 산출물은 정적 HTML과 자산 또는 서버 실행에 필요한 메타데이터와 추적 파일이며, 선택한 output 방식과 배포 환경에 따라 사용 경로가 달라집니다.

핵심 답변

Next.js에서 output을 export로 설정하면 공개 가능한 정적 파일은 out 디렉터리에 생성됩니다. 서버 실행 배포는 .next의 서버 메타데이터와 추적 파일을 사용하므로, 호스팅 설정이 어떤 산출물을 요구하는지 먼저 확인해야 합니다.

상세 설명

Next.js의 output: "export"는 빌드 시 경로별 HTML을 생성하고 공개용 결과를 out 디렉터리에 만듭니다. 서버 실행 배포는 .next 아래의 서버 메타데이터와 파일 추적 결과를 사용합니다.

AWS Amplify Hosting은 Next.js 14 이상 정적 배포와 서버 실행 배포 모두에 .next를 산출물 기준 경로로 안내하므로, 일반 정적 호스팅의 out 경로와 Amplify의 프레임워크 계약을 구분해야 합니다.