Мастер и проблемы с запуском
Последнее обновление: 14.10.2026Порт уже используется
Возможная причина
Другой экземпляр 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.
Преобразование завершается сбоем или дает неожиданные результаты в мастере
Возможная причина
Мастер отображает сводную ошибку, но не раскрывает полную диагностическую информацию, необходимую для выявления первопричины.
Предлагаемые меры
Повторно запустите то же преобразование из командной строки с включенным отладочным логированием. Выполните следующие действия.
- В мастере перейдите к шагу Проверка.
- Щелкните Копировать команду, чтобы скопировать полную команду CLI в буфер обмена.
- Откройте окно терминала и вставьте скопированную команду.
- Добавьте
--logLevel DEBUGв конец команды и нажмите Enter.
Консоль отображает подробный вывод, охватывающий каждое решение о преобразовании, вызов облачного API и шаг обработки объекта. Полный отладочный журнал также записывается в logs/ подпапку в выходном каталоге.
Скопированная команда включает все настройки, заданные в мастере. Добавление --logLevel DEBUG — это единственное изменение, необходимое для включения полной диагностики.
См. Ведение журнала и диагностика для получения подробных сведений о формате файла журнала и Местоположение.
Модальное окно QV2QS остановился
появляется в браузере
Возможная причина
Процесс QV2QS был закрыт, завершился с ошибкой или был прекращен, пока мастер был еще открыт в браузере. Пользовательский интерфейс отслеживает работу серверной службы с помощью периодической проверки работоспособности и отображает модальное окно, когда служба становится недоступной.
Предлагаемые меры
Выполните одно из следующих действий:
- Переподключиться к текущему сеансу. Скопируйте команду, отображаемую в модальном окне, и запустите команду в терминале. Команда включает
--portи--noBrowserдля повторного подключения к той же вкладке браузера на том же порту. После запуска сервера нажмите Переподключиться в модальном окне. Мастер возобновляет работу, сохраняя все ранее введенные настройки. - Закройте вкладку браузера. Нажмите Закрыть окно в модальном окне. Любые несохраненные настройки в текущем сеансе мастера будут потеряны.
Файл примера проекта отсутствует или поврежден
Возможная причина
Пример файла QVW в %TEMP%\QV2QS\examples\ был удален, перемещен или изменен вне QV2QS.
Предлагаемые меры
Удалите затронутый файл из %TEMP%\QV2QS\examples\ и перезапустите QV2QS. Новая копия извлекается автоматически при запуске. Чтобы сохранить постоянную копию файла-примера, скопируйте файл в локальную рабочую папку перед изменением. См. Примеры проектов.