문제 해결
자주 발생하는 문제와 해결 방법
키오스크 운영 중 자주 발생하는 문제와 해결 방법을 안내합니다. 각 문제에 대해 증상, 원인, 해결 방법 순서로 설명합니다.
카메라 문제
카메라가 인식되지 않습니다
증상: 관리자 설정의 카메라 관리에서 카메라 드롭다운 목록이 비어있거나, 촬영 화면에서 카메라 영상이 나타나지 않습니다.
원인: USB 카메라가 물리적으로 연결되지 않았거나, 운영체제에서 카메라 장치를 인식하지 못하는 경우입니다.
해결 방법:
- USB 케이블이 올바르게 연결되어 있는지 확인합니다.
- 다른 USB 포트에 연결해 봅니다.
- Windows 설정 > 개인 정보 > 카메라에서 앱의 카메라 접근이 허용되어 있는지 확인합니다.
- Windows 장치 관리자에서 카메라 장치가 정상적으로 표시되는지 확인합니다.
- 앱을 종료한 뒤 다시 실행합니다.
카메라 화면이 검게 표시됩니다
증상: 카메라가 목록에는 표시되지만, 촬영 화면이나 카메라 테스트에서 검은 화면만 보입니다.
원인: 다른 프로그램이 카메라를 점유하고 있거나, 카메라 밝기 설정이 극단적으로 낮은 경우입니다.
해결 방법:
- 카메라를 사용하는 다른 프로그램(화상 통화, 카메라 앱 등)을 모두 종료합니다.
- 관리자 설정의 카메라 관리에서 밝기 설정을 확인합니다. 소프트웨어 밝기가 지나치게 낮으면(0.5 이하) 기본값(1.0)으로 되돌립니다.
- USB 케이블을 분리했다가 다시 연결합니다.
- 앱을 재시작합니다.
프린터 문제
인쇄가 되지 않습니다
증상: 촬영 완료 후 인쇄 단계에서 사진이 출력되지 않습니다.
원인: 프린터가 선택되지 않았거나, 프린터 연결에 문제가 있는 경우입니다.
해결 방법:
- 관리자 설정의 프린터 관리에서 기본 프린터가 올바르게 선택되어 있는지 확인합니다.
- 프린터 전원이 켜져 있고 용지가 충분한지 확인합니다.
- 프린터 관리 화면의 새로고침 버튼을 눌러 프린터 목록을 갱신합니다.
- Windows 설정에서 프린터 상태가 "준비됨"인지 확인합니다. 오류 상태라면 프린터를 재시작합니다.
- 프린터 드라이버를 최신 버전으로 업데이트합니다.
인쇄 품질이 낮습니다
증상: 인쇄된 사진이 흐리거나 색상이 이상하게 출력됩니다.
원인: 프린터 용지 또는 잉크/리본 상태가 좋지 않거나, 프린터 드라이버 설정이 적절하지 않은 경우입니다.
해결 방법:
- 프린터 전용 포토 용지를 사용하고 있는지 확인합니다.
- 잉크 카트리지 또는 리본이 충분히 남아 있는지 확인합니다.
- 프린터 드라이버 설정에서 인쇄 품질이 "고화질" 또는 "최상"으로 되어 있는지 확인합니다.
- 프린터 헤드 청소를 실행합니다 (프린터 제조사 매뉴얼 참고).
화면 문제
화면 레이아웃이 깨집니다
증상: 화면의 버튼, 텍스트, 이미지 등이 잘리거나 겹쳐 보입니다.
원인: 디스플레이 해상도 또는 배율 설정이 권장 사양과 다른 경우입니다. 키오스크는 1920x1200~1920x1280 해상도에서 DPR(디스플레이 배율) 150%를 기준으로 설계되었습니다.
해결 방법:
- Windows 설정 > 디스플레이에서 해상도를 1920x1200 또는 1920x1280으로 설정합니다.
- 배율(크기 조정)을 **150%**로 설정합니다.
- 앱을 재시작하여 변경 사항을 적용합니다.
터치가 반응하지 않습니다
증상: 터치스크린을 눌러도 화면이 반응하지 않습니다.
원인: 터치스크린 드라이버 문제이거나, 터치 입력이 다른 디스플레이에 매핑되어 있는 경우입니다.
해결 방법:
- Windows 설정 > 장치에서 터치스크린이 인식되어 있는지 확인합니다.
- 멀티 모니터 환경이라면, Windows의 태블릿 PC 설정에서 터치 화면 보정을 진행하여 터치 입력이 올바른 디스플레이에 매핑되도록 합니다.
- 터치스크린 드라이버를 재설치합니다.
- USB 터치스크린인 경우, USB 케이블을 분리했다가 다시 연결합니다.
앱 실행 문제
앱이 시작되지 않습니다
증상: 바탕화면 바로가기를 눌러도 앱 창이 나타나지 않거나, 즉시 종료됩니다.
원인: 앱 설치 파일이 손상되었거나, 필수 시스템 구성 요소가 누락된 경우입니다.
해결 방법:
- 컴퓨터를 재시작한 뒤 다시 시도합니다.
- Windows 설정의 앱 및 기능에서 앱을 제거한 뒤 다시 설치합니다.
- 바이러스 백신 프로그램이 앱을 차단하고 있지 않은지 확인합니다. 필요한 경우 예외 목록에 추가합니다.
화면이 흰색으로 멈춥니다
증상: 앱이 실행되었지만 흰색 화면만 표시되고 아무 내용이 나타나지 않습니다.
원인: 백엔드 서버와의 연결에 실패했거나, 내부 웹 페이지 로딩에 문제가 발생한 경우입니다.
해결 방법:
- 인터넷 연결 상태를 확인합니다.
- 앱을 완전히 종료(작업 관리자에서 프로세스 종료)한 뒤 다시 실행합니다.
- 문제가 지속되면 앱을 재설치합니다.
네트워크 문제
백엔드 서버에 연결할 수 없습니다
증상: 앱 실행 시 서버 연결 오류가 표시되거나, 설정 변경/사진 저장 등의 기능이 작동하지 않습니다.
원인: 인터넷 연결이 불안정하거나, 백엔드 서버가 일시적으로 중단된 경우입니다.
해결 방법:
- 컴퓨터의 인터넷 연결 상태를 확인합니다. 브라우저에서 아무 웹사이트나 접속해 봅니다.
- 공유기(라우터)를 재시작합니다.
- 방화벽 설정에서 앱의 네트워크 접근이 차단되어 있지 않은지 확인합니다.
- 문제가 지속되면 운영 담당자에게 서버 상태를 문의합니다.
QR 코드가 생성되지 않습니다
증상: 촬영 완료 후 QR 코드 화면에서 QR 코드가 표시되지 않거나 로딩 중 상태가 계속됩니다.
원인: 사진 업로드가 완료되지 않았거나, 서버와의 통신이 원활하지 않은 경우입니다.
해결 방법:
- 인터넷 연결 상태를 확인합니다.
- 잠시 기다린 후에도 QR 코드가 나타나지 않으면, 홈 화면으로 돌아가 다시 촬영을 진행합니다.
- 문제가 반복되면 네트워크 환경(Wi-Fi 신호 강도, 유선 연결 상태)을 점검합니다.
개발 환경 문제
개발자를 위한 추가 문제 해결 안내입니다.
shared 패키지 빌드 누락
증상: 웹 또는 Electron 앱의 타입 체크나 빌드가 실패하며, @photonemo/shared 관련 오류가 표시됩니다.
해결 방법: 다른 앱을 빌드하기 전에 반드시 shared 패키지를 먼저 빌드합니다.
pnpm -F @photonemo/shared build.next 캐시 문제
증상: 의존성 설치 후 웹 개발 서버에서 모듈 해석 오류가 발생합니다.
해결 방법: .next 캐시 폴더를 삭제하고 개발 서버를 재시작합니다.
rm -rf apps/web/.next
pnpm -F @photonemo/web dev