AWS Amplify에서 Next.js 배포가 완료되지 않아요
AWS Amplify의 Next.js 빌드가 성공한 뒤 required-server-files.json 누락 오류로 배포되지 않을 때 확인 문서로 이동합니다.
빠른 답변
Amplify의 Next.js 배포가 완료되지 않으면 빌드 로그의 오류 문구와 앱 루트·산출물 경로를 기록한 뒤 해당 오류 문서를 확인해야 합니다. 임의로 정적 Export나 산출물 경로를 바꾸지 마세요.
이 가이드가 맞는 경우
- 빌드 성공, 배포 실패
- 서버 실행 파일 누락
상황별 다음 단계
호스팅사·개발자에게 전달할 내용
변경 전 기록
- Amplify 빌드 URL, 오류 메시지 전체와 실패 시각을 전달합니다.
- 모노리포 앱 루트, 빌드 명령, artifacts 설정을 전달합니다.
- Next.js 버전과 빌드 산출물 경로를 전달합니다.
알아둘 점
Amplify에서 빌드가 끝났더라도 배포 단계가 실패할 수 있습니다. 실패 단계, 오류 원문, 앱 루트와 산출물 경로를 기록하고 위 오류 문서로 이동하세요.
먼저 기록할 것
- Amplify 로그에서 오류가 난 단계와 원문 메시지를 기록합니다.
- 앱 루트, 빌드 명령, artifacts 설정을 기록합니다.
- Next.js 버전과 생성된
.next산출물 위치를 기록합니다.
오류 문구가 다르면 이 가이드의 한 가지 사례로 원인을 추정하지 마세요. 로그의 첫 오류를 기준으로 문서를 찾으세요.
참고 자료
Deploy a Next.js app to Amplify Hosting (새 창에서 열림)
AWS · 공식 자료 · 확인 범위: guide-branch-amplify-nextjs-deployment · 확인일: 2026-07-27