마법사 및 시작 문제

마지막 업데이트: 2026. 10. 14.

포트가 이미 사용 중입니다

가능한 원인

QV2QS의 다른 인스턴스 또는 다른 애플리케이션이 동일한 네트워크 포트를 사용하고 있습니다.콘솔에 표시됩니다 ERROR: Port [number] is already in use.

제안 조치

다른 애플리케이션을 닫거나, --port을(를) 사용하여 다른 포트를 지정하세요.--port 0를 사용하여 시스템이 사용 가능한 포트를 자동으로 선택하도록 허용합니다.

마법사가 Internet Explorer에서 열리거나 올바르게 렌더링되지 않습니다.

가능한 원인

Internet Explorer는 해당 시스템의 기본 브라우저입니다.QV2QS 사용자 인터페이스는 최신 브라우저가 필요하며 Internet Explorer에서는 작동하지 않습니다.

제안 조치

Google Chrome, Microsoft Edge, 또는 Mozilla Firefox를 설치하십시오.QV2QS는 시작 시 기본 브라우저를 감지하고, 지원되는 브라우저가 있는 경우 자동으로 엽니다.지원되는 브라우저를 찾을 수 없는 경우, 콘솔에 다운로드 링크가 표시됩니다.

Windows Server 2019에서는 Internet Explorer가 기본적으로 설치된 유일한 브라우저입니다.마법사 모드에서 QV2QS를 실행하기 전에 지원되는 브라우저를 설치하십시오.또는 브라우저가 필요 없는 명령줄 인터페이스를 사용하십시오.CLI 인수의 전체 목록은 인수 참조를 참조하세요.

마법사에서 변환이 실패하거나 예기치 않은 결과를 생성합니다.

가능한 원인

마법사가 요약 오류를 표시하지만, 근본 원인을 식별하는 데 필요한 전체 진단 세부 정보는 노출하지 않습니다.

제안 조치

디버그 로깅을 활성화한 상태로 명령줄에서 동일한 변환을 다시 실행하세요.다음을 수행합니다.

1. 마법사에서 검토 단계로 이동합니다.
2. 명령 복사를 클릭하여 전체 CLI 명령어를 클립보드에 복사합니다.
3. 터미널 창을 열고 복사한 명령을 붙여넣으세요.
4. --logLevel DEBUG를 명령의 끝에 추가하고 Enter 키를 누릅니다.

콘솔에 모든 변환 결정, 클라우드 API 호출 및 객체 처리 단계를 포함하는 상세 출력이 표시됩니다.전체 디버그 로그는 출력 디렉터리의 logs/ 하위 폴더에도 기록됩니다.

로그 파일 형식 및 위치에 대한 자세한 내용은 로깅 및 진단을(를) 참조하십시오.

QV2QS이(가) 중지되었습니다 모달이 브라우저에 표시됩니다

가능한 원인

QV2QS 프로세스가 마법사가 브라우저에서 여전히 열려 있는 동안 닫히거나, 충돌하거나, 종료되었습니다.사용자 인터페이스는 주기적인 상태 확인을 통해 백엔드 서비스를 모니터링하고, 서비스에 연결할 수 없게 되면 모달을 표시합니다.

제안 조치

다음 중 하나를 수행합니다.

• 현재 세션에 다시 연결합니다.모달에 표시된 명령을 복사하고 터미널에서 명령을 실행합니다.이 명령에는 --port 및 --noBrowser가 포함되어 있어 동일한 포트에서 동일한 브라우저 탭에 다시 연결할 수 있습니다.서버가 시작되면 모달에서 다시 연결을 클릭합니다.마법사가 이전에 입력된 모든 설정이 그대로 유지된 채로 다시 시작됩니다.
• 브라우저 탭을 닫습니다.모달에서 창 닫기를 클릭하세요.현재 마법사 세션에서 저장되지 않은 설정은 모두 손실됩니다.

예제 프로젝트 파일이 없거나 손상되었습니다.

가능한 원인

예제 QVW 파일이 %TEMP%\QV2QS\examples\ QV2QS 외부에서 삭제, 이동 또는 수정되었습니다.

제안 조치

해당 파일을 %TEMP%\QV2QS\examples\에서 삭제하고 QV2QS를 다시 시작하십시오.실행 시 새 복사본이 자동으로 추출됩니다.예제 파일의 영구 복사본을 보관하려면, 수정하기 전에 파일을 로컬 작업 폴더로 복사하십시오.예제 프로젝트를 참조하십시오.

자세히 알아보기

• 빠른 시작
• 예시 프로젝트
• 마법사 단계