DEV WIKI
프론트엔드 · 문제 해결 가이드

환경 변수가 없어 배포 뒤 기능이 동작하지 않아요

환경 변수가 없어 배포 뒤 기능이 동작하지 않아요 상황에서 화면, 로그, 관리자 도구에 보이는 관찰값을 기록하고 일치하는 Problem 문서를 고르는 가이드입니다.

빠른 답변

환경 변수가 없어 배포 뒤 기능이 동작하지 않아요 상황에서는 화면·로그·관리자 도구에 실제로 표시된 문구와 발생 시각을 먼저 기록한 뒤, 이 가이드의 조건과 일치하는 Problem 문서를 선택합니다. 이 문서는 원인과 복구를 단정하지 않습니다.

적용 범위
이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
출처 확인일
2026-07-27
최종 검토
2026-07-29
수정일
2026-07-29
대상
사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
오류·수정 제보 (새 창에서 열림)

이 가이드가 맞는 경우

  • 빌드 성공, 배포 실패
  • 서버 실행 파일 누락
  • 애플리케이션 오류 메시지

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • 문제가 발생한 URL, 화면 또는 로그의 원문, 최초 발생 시각을 전달합니다.
  • 비밀번호, 인증 토큰, 세션 쿠키, 결제 정보, 개인정보는 전달하지 않습니다.
  • 최근 배포, 설정, 도메인, 플러그인 또는 인프라 변경이 있었다면 시각과 변경 범위를 함께 전달합니다.

알아둘 점

이 가이드는 환경 변수가 없어 배포 뒤 기능이 동작하지 않아요 상황에서 화면·로그·관리자 도구에 실제로 표시된 문구와 발생 시각을 기록한 뒤, 일치하는 Problem 문서로 안내합니다. 이 문서는 원인과 복구를 단정하지 않습니다.

적용되는 시작 상황

다음 관찰값을 확인합니다.

  • Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음
  • CustomerError: Can't find required-server-files.json in build output directory
  • Production deployment cannot be redeployed

먼저 기록할 것

  1. 문제가 발생한 URL 또는 기능과 최초 발생 시각을 기록합니다.
  2. 화면, 브라우저 개발자 도구, 서버 로그, 관리자 도구 중 실제로 확인한 위치를 기록합니다.
  3. 오류 문구 또는 상태 코드를 원문 그대로 기록합니다.
  4. 최근 배포·설정·도메인·플러그인 변경이 있었다면 변경 시각과 범위를 기록합니다.

상황별 다음 단계

  1. Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음과 일치하면 Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음 문서를 확인합니다.
  2. CustomerError: Can't find required-server-files.json in build output directory과 일치하면 CustomerError: Can't find required-server-files.json in build output directory 문서를 확인합니다.
  3. Production deployment cannot be redeployed과 일치하면 Production deployment cannot be redeployed 문서를 확인합니다.

위 조건과 일치하지 않으면 원문을 보존하고 담당자에게 전달합니다. 비밀번호·토큰·세션 쿠키·결제 정보·개인정보는 전달하지 않습니다.

참고 자료

Configuring monorepo applications - AWS Amplify Hosting (새 창에서 열림)

AWS · 공식 자료 · 확인 범위: Amplify는 모노리포에서 appRoot로 애플리케이션 경로를 지정합니다., AMPLIFY_MONOREPO_APP_ROOT는 appRoot와 같은 값을 가져야 합니다., buildPath와 artifacts.baseDirectory는 빌드 및 산출물 경로 설정에 사용됩니다. · 확인일: 2026-07-27

AWS · 공식 자료 (새 창에서 열림)

확인 범위: amplify-nextjs-output-directory, static-and-server-deployment-settings · 확인일: 2026-07-22

Error List (새 창에서 열림)

Vercel · 공식 자료 · 확인 범위: 공식 원문에 오류 문구와 해당 항목의 발췌문이 있습니다. · 확인일: 2026-07-24