배포 뒤 API 요청만 실패해요
배포 뒤 API 요청만 실패해요 상황에서 화면, 로그, 관리자 도구에 보이는 관찰값을 기록하고 일치하는 Problem 문서를 고르는 가이드입니다.
빠른 답변
배포 뒤 API 요청만 실패해요 상황에서는 화면·로그·관리자 도구에 실제로 표시된 문구와 발생 시각을 먼저 기록한 뒤, 이 가이드의 조건과 일치하는 Problem 문서를 선택합니다. 이 문서는 원인과 복구를 단정하지 않습니다.
이 가이드가 맞는 경우
- 빌드 성공, 배포 실패
- 서버 실행 파일 누락
- 애플리케이션 오류 메시지
상황별 다음 단계
Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
화면, 로그 또는 관리자 도구에 Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음와 일치하는 문구·상태가 표시됩니다.
CustomerError: Can't find required-server-files.json in build output directory
화면, 로그 또는 관리자 도구에 CustomerError: Can't find required-server-files.json in build output directory와 일치하는 문구·상태가 표시됩니다.
ERR_MODULE_NOT_FOUND
화면, 로그 또는 관리자 도구에 ERR_MODULE_NOT_FOUND와 일치하는 문구·상태가 표시됩니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 문제가 발생한 URL, 화면 또는 로그의 원문, 최초 발생 시각을 전달합니다.
- 비밀번호, 인증 토큰, 세션 쿠키, 결제 정보, 개인정보는 전달하지 않습니다.
- 최근 배포, 설정, 도메인, 플러그인 또는 인프라 변경이 있었다면 시각과 변경 범위를 함께 전달합니다.
알아둘 점
이 가이드는 배포 뒤 API 요청만 실패해요 상황에서 사용자가 직접 확인할 수 있는 문구·상태를 기준으로 다음 Problem 문서를 선택합니다. 아래 문서의 원인과 조치를 이 Guide가 대신 설명하지 않습니다.
적용되는 시작 상황
이 문서에서 연결한 확인 대상은 다음과 같습니다.
- Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
- CustomerError: Can't find required-server-files.json in build output directory
- ERR_MODULE_NOT_FOUND
먼저 기록할 것
- 문제가 발생한 주소와 최초 발생 시각을 기록합니다.
- 화면, 브라우저 개발자 도구, 서버 로그, 관리자 도구 중 실제로 확인한 위치를 기록합니다.
- 오류 문구 또는 상태 코드를 원문 그대로 기록합니다.
- 최근 배포·설정·도메인 변경이 있었다면 변경 시각과 범위를 함께 기록합니다.
상황별 다음 단계
- Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음와 일치하면 Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음 문서를 확인합니다.
- CustomerError: Can't find required-server-files.json in build output directory와 일치하면 CustomerError: Can't find required-server-files.json in build output directory 문서를 확인합니다.
- ERR_MODULE_NOT_FOUND와 일치하면 ERR_MODULE_NOT_FOUND 문서를 확인합니다.
위 조건과 일치하지 않으면 화면·로그의 원문을 보존한 뒤 관련 담당자에게 전달하세요. 이 가이드는 설정 변경, 배포 재시도, 결제 승인·취소, 데이터 수정 같은 작업을 안내하지 않습니다.
참고 자료
AWS · 공식 자료 · 확인 범위: Amplify는 모노리포에서 appRoot로 애플리케이션 경로를 지정합니다., AMPLIFY_MONOREPO_APP_ROOT는 appRoot와 같은 값을 가져야 합니다., buildPath와 artifacts.baseDirectory는 빌드 및 산출물 경로 설정에 사용됩니다. · 확인일: 2026-07-27
확인 범위: amplify-nextjs-output-directory, static-and-server-deployment-settings · 확인일: 2026-07-22
Node.js · 공식 자료 · 확인 범위: Node.js에서는 error.code가 오류 종류를 식별하는 문자열 레이블이며 오류 식별에 가장 안정적인 방법입니다., ERR_MODULE_NOT_FOUND는 ECMAScript 모듈 로더가 import 작업 또는 프로그램 진입점 로드 중 모듈 파일을 해석하지 못했을 때 사용됩니다., Node.js는 오류 메시지 대신 error.code로 오류 종류를 식별하도록 안내합니다. · 확인일: 2026-07-27