본문으로 건너뛰기

앱이 새로고침되거나 빈 화면이 표시됨

빠른 설정

대부분의 새로고침 또는 빈 화면 문제는 새로고침하고 캐시를 삭제하면 2분 이내에 해결됩니다.

이 가이드는 AVA가 계속 새로고침되거나 빈 화면을 표시하거나 체크인을 시작하지 못할 때 복구하는 방법을 안내합니다. 키오스크는 최신 번들을 불러오기 위해 업데이트 후 한 번 새로고침될 수 있습니다. AVA는 PMS 기반 체크인 설정을 불러오는 동안 잠시 기다릴 수도 있습니다.

빠른 참고​

보이는 현상발생 이유조치
체크인에 **Starting check-in...**이 표시됨AVA가 보안 시작 설정 또는 PMS 기반 설정을 불러오는 중임잠시 기다리거나 다시 시도
"Unable to start check-in"보안 시작을 완료하지 못함연결 상태를 확인하고 다시 시도
로그인 후 빈 화면브라우저가 여전히 오래된 파일을 사용 중임새로고침하고 앱 다시 열기
로그인 직후 또는 업데이트 후 페이지가 한 번 새로고침됨앱이 새 파일로 업데이트 중임새로고침이 끝날 때까지 기다리기
번역을 변경한 후 언어 선택기가 계속 새로고침됨앱이 번역 업데이트에서 복구 중임안정될 때까지 기다리기
탭으로 돌아온 후 잠깐 새로고침됨AVA가 백그라운드 세션을 확인하는 중임몇 초 기다리기
선택한 페이지가 즉시 열리지 않음AVA가 해당 페이지의 파일을 불러오는 중임새로고침하기 전에 기다리기
왼쪽 패널에 "Navigation unavailable"이 표시됨사이드바를 렌더링하지 못함사이드바 다시 시도
버튼이 반응하지 않음페이지 일부가 로드되지 않음새로고침하고 캐시 삭제

빠른 복구 단계​

  1. 앱이 자동으로 새로고침되는지 10초 동안 기다립니다.
  2. 브라우저의 Refresh 버튼을 선택합니다.
  3. 화면이 계속 비어 있으면 탭을 닫고 앱을 다시 엽니다.
  4. 문제가 반복되면 1분 기다렸다가 다시 시도합니다.

✅ 대부분의 경우 이 단계를 거치면 앱이 정상적으로 로드됩니다.

자세한 해결 단계​

1단계: 페이지 새로고침​

  1. 브라우저의 Refresh 버튼을 선택합니다.
  2. 페이지 로드가 완료될 때까지 기다립니다.

✅ 대시보드 또는 마지막으로 보던 페이지가 표시되어야 합니다.

2단계: 오래된 파일 삭제(브라우저 캐시)​

새로고침이 작동하지 않을 때만 다음 단계를 수행합니다.

  1. 브라우저 설정을 엽니다.
  2. Privacy 또는 History로 이동합니다.
  3. Cached images and files를 삭제합니다.
  4. 앱을 다시 로드합니다.

✅ 앱이 최신 버전을 로드해야 합니다.

3단계: 새 탭으로 시도​

  1. 새 탭을 엽니다.
  2. AVA 웹 주소를 입력합니다.
  3. 필요한 경우 다시 로그인합니다.

✅ 새 탭에서는 깨끗한 파일이 로드되는 경우가 많습니다.

흔한 상황​

상황 1: 앱이 계속 새로고침됨

  • 다시 시도하기 전에 1분 기다립니다.
  • 그런 다음 한 번 새로고침합니다.

✅ 앱은 1분 이내에 반복되는 새로고침을 방지합니다.

상황 2: 한 기기에서만 화면이 비어 있음

  • 해당 기기에서 브라우저 캐시를 삭제합니다.
  • 가능하면 다른 브라우저를 사용해 봅니다.

✅ 이는 해당 기기에 저장된 오래된 파일이 원인임을 의미합니다.

문제 해결​

체크인에 로딩 화면이 표시됨​

보이는 현상: 앱이 로드되기 전에 **Starting check-in...**이 표시됩니다.

해결:

  1. 시작 설정이 로드될 때까지 최대 10초 기다립니다.
  2. 버튼이 나타나면 Retry를 누릅니다.
  3. 그래도 계속되지 않으면 페이지를 새로고침합니다.
  4. 문제가 반복되면 다시 로그인합니다.

"Unable to start check-in"​

보이는 현상: 페이지에 재시도 화면이 표시되고 안전하게 연결하지 못했다는 메시지가 나옵니다.

해결:

  1. 인터넷 연결을 확인합니다.
  2. Retry를 누릅니다.
  3. 오류가 다시 나타나면 페이지를 새로고침합니다.
  4. 페이지가 계속 실패하면 다시 로그인합니다.

페이지가 계속 새로고침됨​

보이는 현상: 페이지가 한 번 넘게 새로고침됩니다.

해결:

  1. 1분 기다립니다.
  2. 페이지를 한 번 새로고침합니다.
  3. 반복되면 캐시된 파일을 삭제합니다.

번역 변경 후 새로고침됨​

보이는 현상: 번역을 수정하거나 언어를 전환한 후 페이지가 계속 새로고침됩니다.

해결:

  1. 1분 기다립니다.

  2. 페이지를 한 번 새로고침합니다.

  3. 계속 반복되면 캐시된 파일을 삭제하고 다시 로그인합니다.

    ✓ 번역 업데이트가 완료되면 페이지 새로고침이 멈춰야 합니다.

탭으로 돌아온 후 화면이 잠깐 깜빡임​

보이는 현상: AVA로 돌아왔을 때 짧게 새로고침되는 깜빡임이 보입니다.

해결:

  1. 같은 탭에서 5~10초 기다립니다.
  2. 전체 새로고침 없이 페이지가 안정되는지 확인합니다.
  3. 깜빡임이 자주 반복될 때만 한 번 새로고침합니다.

선택한 페이지가 열리는 데 잠시 시간이 걸림​

보이는 현상: 메뉴 항목을 선택했지만 현재 페이지가 잠시 계속 표시됩니다.

해결:

  1. 선택한 페이지가 열릴 때까지 기다립니다.
  2. AVA가 새 페이지를 로드하는 동안 현재 페이지를 열어 둡니다.
  3. 기다린 후에도 선택한 페이지가 열리지 않을 때 한 번 새로고침합니다.

✓ 새 페이지가 로드되는 동안 현재 페이지가 계속 표시되는 것은 정상입니다.

로그인 후 빈 화면​

보이는 현상: 앱이 로드되어야 하는데 흰색 또는 빈 페이지가 표시됩니다.

해결:

  1. 페이지를 새로고침합니다.
  2. 새 탭에서 앱을 엽니다.
  3. 필요한 경우 캐시된 파일을 삭제합니다.

업데이트 후 키오스크에 이전 필드가 계속 표시됨​

보이는 현상: 배포 후에도 키오스크 또는 체크인 페이지에서 새 필드가 계속 숨겨져 있습니다.

해결:

  1. 한 번 발생하는 새로고침이 완료될 때까지 기다립니다.
  2. 키오스크 페이지를 한 번 새로고침합니다.
  3. 이전 필드가 계속 표시되면 탭을 닫고 체크인 링크를 다시 엽니다.
  4. 같은 기기에서 계속 발생하면 캐시된 파일을 삭제합니다.

버튼이 작동하지 않음​

보이는 현상: 클릭해도 아무 반응이 없습니다.

해결:

  1. 페이지를 새로고침합니다.
  2. 로그아웃한 후 다시 로그인합니다.
  3. 다른 브라우저를 사용해 봅니다.

보이는 현상: 왼쪽 패널에 "Navigation unavailable" 또는 "Sidebar crashed."가 표시됩니다.

해결:

  1. 현재 페이지에서 계속 작업합니다.
  2. 왼쪽 패널에서 Try again을 선택합니다.
  3. 패널이 여전히 로드되지 않으면 한 번 새로고침합니다.
  4. 필요한 경우 로그아웃한 후 다시 로그인합니다.

그래도 해결되지 않나요?​

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

  • ❌ 10분이 지나도 앱이 여전히 빈 화면임
  • ❌ 새로고침 후에도 체크인 재시도 화면이 계속 나타남
  • ❌ 로그인할 때마다 앱이 새로고침됨
  • ❌ 여러 직원에게 같은 문제가 발생함

함께 보내면 유용한 정보:

  • 문제가 시작된 시간
  • 브라우저 이름 및 버전
  • 빈 화면의 스크린샷