> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 배포 문제 해결

> 게시된 Replit 앱을 변경하기 전에 로그를 사용해 게시 실패, 시작 및 상태 점검 실패, 502 응답, Preview와의 차이를 진단하세요.

[Replit Status](https://status.replit.com)를 확인한 다음, 실패가 빌드, 시작, 요청 처리 중 어디에서 발생하는지 파악하세요. 다시 시도하기 전에 실패한 배포의 로그를 보관하세요. 구성 세부 정보는 [게시 문제 해결](/ko/build/troubleshooting)을 참조하세요.

## 빌드 중 게시가 실패하는 경우

1. **Publishing**과 실패한 배포의 로그를 여세요.
2. 마지막 "build failed" 메시지만 보지 말고 조치할 수 있는 첫 번째 오류를 찾으세요.
3. 빌드 명령, 종속성 설치, 참조된 파일 경로를 확인하세요.
4. 게시에 필요한 환경 변수가 구성되어 있는지 확인하세요.
   Preview가 작동한다고 해서 프로덕션 구성이 검증되는 것은 아닙니다.
5. 확인된 문제를 수정하고 다시 게시한 다음 새 로그를 비교하세요.

실행 명령이 없다면 게시 구성을 확인하고 의도한 명령을 저장한 후 다시 시도하세요. 변경되지 않은 빌드를 반복해서 다시 게시하지 마세요.

## 빌드는 성공하지만 시작 또는 상태 점검이 실패하는 경우

실행 명령이 종료되는 빌드 프로세스가 아니라 계속 실행되는 서버를 시작하는지 확인하세요. 웹 서버의 경우 바인드 주소와 포트 구성을 확인하세요. `localhost`에서만 수신 대기하지 말고 외부 연결을 받아야 합니다.

명시적인 포트 매핑을 변경하기 전에 [포트 구성](/ko/build/troubleshooting)을 읽어보세요. 서버가 요청을 받기 시작하기 전에 누락된 프로덕션 시크릿, 데이터베이스 오류, 예외가 있는지 시작 로그를 확인하세요.

배포를 통과시키려고 인증이나 애플리케이션 검사를 무분별하게 제거하지 마세요. 실패하는 라우트나 시작 종속성을 진단하세요.

## 게시된 앱이 500 또는 502를 반환하는 경우

1. 요청 하나를 재현하고 그 시각과 영향을 받은 URL을 기록하세요.
2. 해당 시각 전후의 런타임 로그에서 예외, 충돌, 재시작을 확인하세요.
3. 필요한 데이터베이스나 외부 API에 연결할 수 있는지 확인하세요.
4. 실패를 [모니터링](/ko/features/publishing/monitoring-a-deployment)의 CPU 및 메모리 사용량과 비교하세요.

500이나 502는 증상일 뿐 특정 원인의 증거가 아닙니다. [네트워킹 및 앱 오류](/ko/help/networking-and-app-errors)를 참조하세요.

`replit.app` URL은 작동하지만 커스텀 도메인이 실패한다면 [도메인 가이드](/ko/help/troubleshooting/domains)를 사용하세요. 로그인만 실패한다면 [인증 가이드](/ko/help/troubleshooting/auth)를 사용하세요.

## Preview는 작동하지만 게시된 버전은 작동하지 않는 경우

게시된 버전, 빌드 및 실행 명령, 프로덕션 시크릿, 데이터베이스 선택, 인증 구성을 비교하세요. 워크스페이스 시크릿을 업데이트했다고 해서 게시된 앱이 같은 값을 사용하는 것은 아닙니다.

목표를 정한 프로덕션 구성 변경 후에는 게시하고 다시 테스트하세요. 이전 버전을 다시 배포하기 전에 현재 데이터베이스 스키마와 호환되는지 확인하세요. 코드를 다시 배포하는 것은 데이터베이스 복원이 아닙니다.

## 워크스페이스 정책으로 게시가 차단된 경우

"Public deployments are not allowed for this workspace"가 표시되면 워크스페이스 관리자에게 게시 정책을 검토해 달라고 요청하세요. 코드나 데이터를 개인 워크스페이스로 옮겨 정책을 우회하지 마세요.

## 여전히 실패하나요?

프로젝트 URL, 배포 유형, 실패한 단계, 민감 정보를 제거한 빌드 또는 런타임 로그, 실패한 요청의 시각을 지원팀에 보내세요. Preview와 게시된 URL의 동작이 다른지도 알려 주세요. [지원 체크리스트](/ko/help/troubleshooting/overview#지원팀에-문의해야-할-때)를 따르세요.