Assistente e problemas de inicialização
Última atualização: 14/10/2026A porta já está em uso
Possível causa
Outra instância do QV2QS ou outro aplicativo está usando a mesma porta de rede. O console exibe ERROR: Port [number] is already in use.
Ação proposta
Feche o outro aplicativo, ou especifique uma porta diferente com --port. Use --port 0 para permitir que o sistema selecione uma porta disponível automaticamente.
O assistente abre no Internet Explorer ou não é renderizado corretamente
Possível causa
O Internet Explorer é o navegador padrão na máquina. A interface de usuário do QV2QS requer um navegador moderno e não funciona no Internet Explorer.
Ação proposta
Instale o Google Chrome, o Microsoft Edge ou o Mozilla Firefox. QV2QS detecta o navegador padrão na inicialização e abre automaticamente um navegador compatível quando um estiver disponível. Se nenhum navegador compatível for encontrado, o console exibe links para download.
No Windows Server 2019, o Internet Explorer é o único navegador instalado por padrão. Instale um navegador compatível antes de executar o QV2QS no modo assistente. Alternativamente, use a interface de linha de comando, que não requer um navegador. Veja Referência de argumentos para a lista completa de argumentos da CLI.
A conversão falha ou produz resultados inesperados no assistente
Possível causa
O assistente exibe um erro resumido, mas não expõe os detalhes diagnósticos completos necessários para identificar a causa raiz.
Ação proposta
Execute novamente a mesma conversão a partir da linha de comando com o log de depuração ativado. Faça o seguinte:
- No assistente, navegue até a etapa de Revisão.
- Clique em Copiar comando para copiar o comando CLI completo para a área de transferência.
- Abra uma janela de terminal e cole o comando copiado.
- Anexe
--logLevel DEBUGao final do comando e pressione Enter.
O console exibe uma saída detalhada cobrindo cada decisão de conversão, chamada de API da nuvem e etapa de processamento de objeto. O log de depuração completo também é gravado na logs/ subpasta no diretório de saída.
O comando copiado inclui todas as configurações configuradas no assistente. Adicionar --logLevel DEBUG é a única alteração necessária para ativar o diagnóstico completo.
Consulte Registro de logs e diagnósticos para obter detalhes sobre o formato e a localização do arquivo de log.
QV2QS parou
modal aparece no navegador
Possível causa
O processo QV2QS foi fechado, travou ou foi encerrado enquanto o assistente ainda estava aberto no navegador. A interface do usuário monitora o serviço de backend com uma verificação de saúde periódica e exibe o modal quando o serviço se torna inalcançável.
Ação proposta
Realize uma das seguintes ações:
- Reconectar à sessão atual. Copie o comando exibido no modal e execute o comando em um terminal. O comando inclui
--porte--noBrowserpara se reconectar à mesma aba do navegador na mesma porta. Após o servidor iniciar, clique em Reconectar no modal. O assistente é retomado com todas as configurações inseridas anteriormente intactas. - Feche a aba do navegador. Clique Fechar janela no modal. Quaisquer configurações não salvas na sessão atual do assistente serão perdidas.
O arquivo de projeto de exemplo está faltando ou corrompido
Possível causa
O arquivo QVW de exemplo em %TEMP%\QV2QS\examples\ foi excluído, movido ou modificado fora do QV2QS.
Ação proposta
Exclua o arquivo afetado de %TEMP%\QV2QS\examples\ e reinicie o QV2QS. Uma nova cópia é extraída automaticamente no lançamento. Para manter uma cópia permanente de um arquivo de exemplo, copie o arquivo para uma pasta de trabalho local antes de modificar. Ver Projetos de exemplo.