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

배포 뒤 API 요청만 실패해요

배포 뒤 API 요청이 실패할 때 빌드 경로 오류와 Node.js ECONNRESET을 원문 기준으로 구분합니다.

빠른 답변

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

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

이 가이드가 맞는 경우

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

상황별 다음 단계

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

변경 전 기록

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

알아둘 점

이 가이드는 배포 뒤 API 요청만 실패해요 상황에서 화면·로그·관리자 도구에 실제로 표시된 문구와 발생 시각을 기록한 뒤, 일치하는 Problem 문서로 안내합니다. 이 문서는 원인과 복구를 단정하지 않습니다.

적용되는 시작 상황

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

  • ECONNRESET, read ECONNRESET, socket hang up
  • 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. Node.js 로그의 error.codeECONNRESET이면 ECONNRESET 요청·응답 단계 확인 문서를 확인합니다. read ECONNRESETsocket hang uperror.code를 함께 확인합니다.
  2. Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음과 일치하면 Amplify 모노리포 appRoot가 실제 앱 경로와 맞지 않음 문서를 확인합니다.
  3. CustomerError: Can't find required-server-files.json in build output directory과 일치하면 CustomerError: Can't find required-server-files.json in build output directory 문서를 확인합니다.
  4. Production deployment cannot be redeployed과 일치하면 Production deployment cannot be redeployed 문서를 확인합니다.

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

참고 자료

HTTP | Node.js Documentation (새 창에서 열림)

Node.js · 공식 자료 · 확인 범위: 응답 전 연결이 닫히면 요청 객체에서 socket hang up 메시지와 ECONNRESET 코드가 발생할 수 있습니다., 응답을 받은 뒤 연결이 닫히면 응답 객체에서 aborted와 ECONNRESET 오류가 발생할 수 있습니다. · 확인일: 2026-09-03

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