문제 해결 · FAQ
사이트가 “준비중” 그대로예요
섹션 제목: “사이트가 “준비중” 그대로예요”아직 빌드 중이거나 실패했습니다. 5분까지 기다려 보고, 그래도 그대로면 대시보드의 업로드 기록에서 상태와 사유를 확인하세요.
502 가 뜨거나 접속이 안 돼요
섹션 제목: “502 가 뜨거나 접속이 안 돼요”거의 항상 포트 문제입니다. 앱이 0.0.0.0 의 3000 포트를 리슨하는지 확인하세요.
127.0.0.1 로 묶으면 빌드는 성공해도 접속이 안 됩니다. → 배포 방법
빌드가 실패해요
섹션 제목: “빌드가 실패해요”흔한 원인 순서대로:
node_modules를 zip 에 넣음 (맥 바이너리는 리눅스에서 안 돕니다)- 의존성 목록 누락 (
package.json/requirements.txt확인) - 락파일과 실제 의존성 불일치
업로드했는데 “쿨다운” 이라고 떠요
섹션 제목: “업로드했는데 “쿨다운” 이라고 떠요”칸마다 2분에 1회입니다. 메인과 API 는 따로 셉니다.
zip 이 거부돼요
섹션 제목: “zip 이 거부돼요”alz · rar · 7z 는 안 됩니다. zip 만 됩니다.
암호가 걸린 zip 도 거부됩니다.
비밀번호가 안 맞아요
섹션 제목: “비밀번호가 안 맞아요”전부 대문자이고 가운데 - 도 그대로 입력합니다.
헷갈리는 글자(O/0, I/1, S/5)는 아예 쓰지 않았습니다.
종이를 잃어버렸어요
섹션 제목: “종이를 잃어버렸어요”운영진에게 말씀하세요. 새 비밀번호를 발급합니다 (되찾는 건 불가능합니다).
편집기가 안 열려요
섹션 제목: “편집기가 안 열려요”양식 내려받기 로 받아 한글에서 작성한 뒤 파일로 제출 칸에 올리세요.
“다른 팀원이 먼저 저장했습니다” 가 떠요
섹션 제목: ““다른 팀원이 먼저 저장했습니다” 가 떠요”같은 서류를 둘 이상이 열어 두었습니다. 새로고침해서 최신 문서를 불러온 뒤 이어 쓰세요.
저장했는지 모르겠어요
섹션 제목: “저장했는지 모르겠어요”화면 오른쪽 위의 저장됨 HH:MM:SS 를 확인하세요.
데이터
섹션 제목: “데이터”데이터가 사라졌어요
섹션 제목: “데이터가 사라졌어요”앱 안(파일·SQLite)에 저장하면 업로드할 때마다 사라집니다. 데이터베이스 를 만들어 쓰세요.
DB 에 노트북에서 접속하고 싶어요
섹션 제목: “DB 에 노트북에서 접속하고 싶어요”외부 접속은 막혀 있습니다. 필요하면 privacy@poi.kr 로 문의해 주세요.
여기에 없는 문제는 privacy@poi.kr 로 팀 번호 + 증상 + 화면 사진을 보내 주세요. 급하면 운영 총괄 권민준 카카오톡으로 연락하세요.