Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음

확인

1. 저장소 루트에서 package.json과 Next.js 설정 파일이 있는 실제 애플리케이션 경로를 기록합니다.
2. amplify.yml의 appRoot와 Amplify 콘솔의 AMPLIFY_MONOREPO_APP_ROOT가 같은 경로를 가리키는지 확인합니다.
3. buildPath와 artifacts.baseDirectory가 각각 어느 경로를 기준으로 해석되는지 기록하고, 빌드 로그의 실제 작업 디렉터리와 비교합니다.
4. 같은 커밋에서 로컬 빌드 명령을 실행해 실제 산출물 위치를 확인합니다.

Amplify는 모노리포에서 appRoot로 애플리케이션 경로를 지정하며, AMPLIFY_MONOREPO_APP_ROOT는 같은 값을 가져야 합니다.

주의

appRoot, buildPath, baseDirectory, 빌드 명령을 한 번에 바꾸지 마세요. 배포 환경 변수나 비밀값을 로그·이슈·문의 자료에 복사하지 않습니다.

출처

• AWS Amplify: Configuring monorepo applications (새 창에서 열림)

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

1. 저장소 루트에서 package.json과 Next.js 설정 파일이 있는 실제 애플리케이션 경로를 기록합니다.
2. amplify.yml의 appRoot와 Amplify 콘솔의 AMPLIFY_MONOREPO_APP_ROOT가 같은 경로를 가리키는지 확인합니다.
3. buildPath와 artifacts.baseDirectory가 각각 어느 경로를 기준으로 해석되는지 기록하고, 빌드 로그의 실제 작업 디렉터리와 비교합니다.
4. 같은 커밋에서 로컬 빌드 명령을 실행해 실제 산출물 위치를 확인합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.