본문으로 건너뛰기

node.js 사이트로 접속하면 "Error 503 Service Unavailable"이라고 나와요?

💡 요약 정리

  • git으로 소스를 push한 후 접속 시 503 오류가 보일 수 있습니다.
  • 앱을 재시작하고, 기본 실행 파일명이 web.js인지 확인하세요.
  • 소스 코드의 포트번호가 서비스에 할당된 포트와 일치해야 합니다.
  • 모듈 설치를 위해 package.json 파일이 필요합니다.

1. 이런 증상이 나타나요

git으로 소스 파일을 push한 뒤, 사이트에 접속하면 아래와 같은 503 오류 페이지가 표시될 수 있습니다.

Error 503 Service Unavailable

  Service Unavailable

  Guru Meditation:

  XID: 192392972

  Varnish cache server

2. 이렇게 점검해 보세요

1) 앱을 재시작하세요

  • 소스 push 후에는 앱을 재실행해야 합니다.
  • 나의 서비스 관리 > 앱 생성/관리 메뉴에서 앱을 중지 후 다시 실행할 수 있습니다.

2) 기본 실행 파일명을 확인하세요

  • 앱의 기본 실행 파일명은 web.js입니다.
  • 프로젝트의 시작 파일명이 올바른지 확인하세요.

3) 포트번호 설정을 점검하세요

  • 각 앱에는 고유한 포트번호가 할당됩니다.
  • 소스 코드에서 서버가 할당된 포트로 실행되도록 설정되어 있는지 확인하세요.
node.js 포트 설정 예시 이미지
  • 앱마다 포트가 다를 수 있으며, 소스의 포트 설정과 일치해야 정상 접속됩니다.

4) 모듈 설치 파일을 확인하세요

  • 모듈 설치용 파일은 package.json이어야 합니다.
  • 필요한 의존성이 package.json에 정의되어 있는지 확인하세요.